> ## Documentation Index
> Fetch the complete documentation index at: https://helpdocs.gavel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart Guide

> A step-by-step guide to signing up, building your first workflow, connecting a document template, testing, and sharing with clients.

This guide walks you through building your first Gavel workflow from start to finish. By the end, you will have a working questionnaire connected to an output document — ready to test and share.

<Info>
  Gavel offers a [free trial](https://start.gavel.io/pay?_gl=1*w3sszc*_gcl_aw*R0NMLjE3NzYxMDYxNzAuQ2owS0NRandxUExPQmhDaUFSSXNBS1JNUFpwaFRvRVlHZU8zMXBBeFR6LUVFczBmMEc2NndkTjZzUlBENzhPUHNSTnI2djF2d2EydU1lWWFBakhORUFMd193Y0I.*_gcl_au*MTA0OTQ1MzUxOS4xNzc2MTg0NTQyLjYyNDMzNDQ5OC4xNzc3NDA4NjE0LjE3Nzc0MDg4NDI.) (no credit card needed) so you can build and test before committing to a plan. Visit [gavel.io](https://www.gavel.io) to sign up and learn more.
</Info>

## Before you start

Have a document you want to automate ready. Ideally, choose something you draft frequently with consistently collected information — names, dates, addresses, and so on. A one-page letter or short agreement is a good starting point.

***

## Build your first workflow

<Steps>
  <Step title="Sign up or log in">
    Create your Workflows [Free Trial](https://start.gavel.io/pay?_gl=1*w3sszc*_gcl_aw*R0NMLjE3NzYxMDYxNzAuQ2owS0NRandxUExPQmhDaUFSSXNBS1JNUFpwaFRvRVlHZU8zMXBBeFR6LUVFczBmMEc2NndkTjZzUlBENzhPUHNSTnI2djF2d2EydU1lWWFBakhORUFMd193Y0I.*_gcl_au*MTA0OTQ1MzUxOS4xNzc2MTg0NTQyLjYyNDMzNDQ5OC4xNzc3NDA4NjE0LjE3Nzc0MDg4NDI.), choosing your personalized subdomain (e.g., `yourname`). Verify your email address, and your account will be set up at `yourname.gavel.io`. After signing in to your subdomain, you land on your **Dashboard**, where all your workflows live.
  </Step>

  <Step title="Create a new workflow">
    Click **New Workflow** from the Dashboard. Give it a name that reflects the document you are automating (for example, "Client Engagement Letter"). Gavel opens the **Builder View** — the workflow editor where you design the questionnaire and connect documents.
  </Step>

  <Step title="Add your questions">
    In the Builder View, add questions that correspond to every piece of variable information in your document. For each question:

    1. Click **+ Question** (bottom right) or **+ New → Question** in the left sidebar.
    2. Select the appropriate question type (Text, Date, Yes/No, etc.).
    3. Enter the Question name (a label your respondent will see).
    4. Enter the **Variable Name** (e.g., `ClientFullName`) — you will use this to tag your document template.

    Repeat until you have created a question for every field that will need to exist in your output document.

    <Tip>
      Use descriptive variable names like `ClientFullName` or `EffectiveDate` rather than generic names. You will insert these into your document template, so clarity matters.
    </Tip>
  </Step>

  <Step title="Organize questions into pages">
    Long questionnaires are easier to complete when grouped into logical pages. Click **+ Add Page** (top right) to add a page. Drag questions between pages (using the left sidebar) to arrange them. Each page becomes one screen in the questionnaire experience.

    You can also add **sections** to group pages under a heading, which gives respondents a visual sense of progress (each section name will appear on the left while respondents fill out the questionnaire, showing them how far along they are). Some Builders find it easiest to add sections first, then add pages to each section, then add questions to each page.
  </Step>

  <Step title="Connect a Word or PDF template">
    Navigate to the **Document Templates** tab of your workflow.

    <Tabs>
      <Tab title="Word document (.docx)">
        1. Install the free **Gavel Word Add-in** from the Microsoft AppSource if you haven't already. Follow [these steps](https://gavelworkflows.mintlify.app/workflows/word-documents#install-the-gavel-word-add-in) to get set up.
        2. Open your Word document and use the Add-in to insert variable tags — for example, `{{ ClientFullName }}` — wherever variable content should appear.
        3. Save the document and upload it to the Document Templates tab in Gavel.
      </Tab>

      <Tab title="Fillable PDF">
        1. Upload your fillable PDF to the Document Templates tab.
        2. Click "Edit Tags" to open the **PDF Tagger**, which displays each form field in your PDF.
        3. Map each field to the corresponding variable name from your questionnaire.
        4. Save your field mappings.
      </Tab>
    </Tabs>

    <Note>
      You can attach multiple output documents to a single workflow. All connected templates are generated simultaneously when the questionnaire is submitted. You can also set up document logic to only output certain documents depending on the respondent's answers to the questionnaire.
    </Note>
  </Step>

  <Step title="Test the workflow">
    Save your workflow, and click \*\*Run \*\*in the Builder View to run through the questionnaire as a respondent would. Fill in sample answers and proceed to the output page to confirm that the generated documents look correct.

    Check that:

    * All variable fields populate with the correct answers
    * Conditional clauses show and hide as expected
    * Formatting in the output document matches your template

    <Warning>
      Always test before sharing with clients. A quick test run catches missing variables and formatting issues before they reach a real respondent.
    </Warning>
  </Step>

  <Step title="Share the workflow">
    Once you are satisfied with the test output, choose how you would like to share your workflow. Depending on how you want to use it, you can:

    * **Share a direct link** with specific colleagues or clients
    * **Embed the workflow** on your website or client portal
    * **Restrict access** to specific users or require login
    * **Set it to public** so anyone with the link can complete it

    Respondents follow the link and complete the questionnaire. They can receive the generated documents on the output page, or you can hide the output documents and have them emailed to you for review.
  </Step>
</Steps>

***

## Next steps

Now that you have a working workflow, explore more advanced features to make it smarter and more polished.

<CardGroup cols={2}>
  <Card title="Question types" icon="circle-question" href="/workflows/question-types">
    Learn about all available question types, including text questions, repeating items, and file uploads.
  </Card>

  <Card title="Pages and sections" icon="page" href="/workflows/pages-and-sections">
    Organize your questionnaire into a clean, navigable structure.
  </Card>

  <Card title="Repeating items" icon="repeat" href="/workflows/repeating-items">
    Collect variable-length lists like children, assets, or parties to a contract.
  </Card>

  <Card title="What can you build?" icon="lightbulb" href="/workflows/what-can-you-build">
    Get inspired by use cases and examples from real legal workflows.
  </Card>
</CardGroup>