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

# Forms

> Customize the data you collect from customers in the Dealroom using custom forms

{/* AUDIT NOTE: Nav "Settings → Workspace → Form" confirmed (URL /settings/workspace/form). Form list and editor screens not accessible with this account. All [BUTTON LABEL], [FIELD NAME], and [MENU PATH] TODOs retained. Conceptual content (field types, conditional logic, Dealroom behavior) is plausible but unverified. */}

Forms allow you to collect structured information from your customers directly in the Dealroom. You can create custom forms to gather requirements, qualify needs, or capture additional deal data before signature.

Forms appear as interactive sections in the Dealroom where customers can fill in fields, upload files, and submit responses. You configure forms in your workspace settings and attach them to quote templates.

## Key features

* **Custom fields**: Add text inputs, dropdowns, checkboxes, file uploads, and more
* **Conditional logic**: Show or hide fields based on previous answers
* **Template-level**: Attach forms to specific templates so they appear automatically
* **Submission tracking**: See when customers complete forms and review their responses
* **Pre-filled data**: Auto-populate form fields with quote or customer variables

Form responses are stored with the quote and visible to sales reps in the quote detail view.

## How forms work

```mermaid theme={null}
graph LR
    A[Create Form] --> B[Add Fields]
    B --> C[Configure Logic]
    C --> D[Attach to Template]
    D --> E[Publish Quote]
    E --> F[Customer Fills Form]
    F --> G[Responses Saved]
```

## Creating a form

Navigate to **Settings** > **Workspace** > **Forms** to create and manage forms.

<Steps>
  <Step title="Create a new form">
    Click **\[BUTTON LABEL]** {/* TODO: verify button label */} and enter a form name and optional description. The name appears as the section title in the Dealroom.
  </Step>

  <Step title="Add fields">
    Click **\[BUTTON LABEL]** {/* TODO: verify button label */} to add fields. Configure each field's type, label, placeholder text, and whether it's required.

    Supported field types:

    * Short text
    * Long text (multi-line)
    * Number
    * Email
    * Dropdown (single select)
    * Multi-select
    * Date
    * File upload
    * Checkbox
  </Step>

  <Step title="Set field rules (optional)">
    Use conditional logic to show fields only when certain conditions are met. For example, show a **\[FIELD NAME]** {/* TODO: verify field name */} field only when the customer selects `Enterprise` from a plan dropdown.
  </Step>

  <Step title="Attach to template">
    Open the template you want to use this form with. In the **\[MENU PATH]** {/* TODO: verify menu path */} section, select the form from the dropdown. Multiple forms can be attached to a single template.
  </Step>
</Steps>

## Form responses

When a customer submits a form in the Dealroom, responses are immediately visible to the sales team.

View responses in the quote detail page under the **\[MENU PATH]** {/* TODO: verify section name */} section. Responses are read-only once submitted, but admins and managers can reset forms to allow customers to edit their answers.

<Note>
  Forms can be marked as required. When required, customers cannot proceed to signature until all required forms are completed.
</Note>

## Field mapping

Map form responses to customer or quote custom fields to integrate form data with your CRM or reporting tools.

When you enable field mapping, responses automatically populate the linked custom field when the form is submitted. This allows you to:

* Sync data to your CRM via API
* Use form responses in contract variables
* Filter and report on form data across quotes

## Common questions

<AccordionGroup>
  <Accordion title="Can customers edit form responses after submission?">
    No, responses are locked after submission to maintain data integrity. Admins and managers can reset a form to allow re-submission if needed.
  </Accordion>

  <Accordion title="Are forms versioned with quotes?">
    Yes. Forms are captured as part of the quote snapshot when published. Changes to the form template do not affect already-published quotes.
  </Accordion>

  <Accordion title="Can I use form responses in contract variables?">
    Yes, if you map form fields to custom fields. You can then reference those custom fields in your contract model using variables like `{{quote.custom_field_name}}`.
  </Accordion>

  <Accordion title="What file types can customers upload?">
    File upload fields support common document and image formats. You can configure maximum file size and allowed file types per field. {/* TODO: verify if file type restrictions are configurable */}
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Templates" icon="layer-group" href="/user-guide/templates/introduction">
    Configure templates to include forms automatically
  </Card>

  <Card title="Dealroom" icon="handshake" href="/user-guide/dealroom/introduction">
    Learn how customers interact with forms in the Dealroom
  </Card>

  <Card title="Custom fields" icon="input-text" href="/user-guide/settings/workspace/pdf">
    Create custom fields to store and map form data
  </Card>

  <Card title="Contract models" icon="file-contract" href="/user-guide/documents/reference/contract-model-and-variables">
    Use form responses as variables in contracts
  </Card>
</CardGroup>