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

# Forms

> Create custom application forms with flexible question types to collect information from ambassadors

Forms let you build custom questionnaires that can be attached to tasks or activations. Use them to collect specific information from brand ambassadors — feedback after events, availability confirmations, check-in details, and more.

## Prerequisites

* An active agency account with access to the dashboard

## Creating a form

<Steps>
  <Step title="Navigate to the Forms page">
    From your agency dashboard, click **Forms** in the sidebar. You'll see a list of all your existing forms, each showing the form name, description, question count, and creation date.

    Click the **Create Form** button in the top-right corner.

    <Frame>
      <img src="https://mintcdn.com/promo-d21ea471/CbMgZrn0xhoodcos/images/guides/forms/step-1-forms-list.png?fit=max&auto=format&n=CbMgZrn0xhoodcos&q=85&s=fbf497ac11f7b0437967df3d68cf7f00" alt="Forms list page" width="1440" height="900" data-path="images/guides/forms/step-1-forms-list.png" />
    </Frame>
  </Step>

  <Step title="Enter form details">
    On the Create Form page, fill in the **Form Name** (required) and an optional **Description**. The name helps you identify the form when attaching it to tasks later.

    <Frame>
      <img src="https://mintcdn.com/promo-d21ea471/CbMgZrn0xhoodcos/images/guides/forms/step-3-fill-form-details.png?fit=max&auto=format&n=CbMgZrn0xhoodcos&q=85&s=24630a3d45c473cb7fdb51344307f049" alt="Create form page with details filled in" width="1440" height="900" data-path="images/guides/forms/step-3-fill-form-details.png" />
    </Frame>
  </Step>

  <Step title="Add a question">
    Click **+ Add Question** to add your first question. Each question has:

    * **Question text** — The question ambassadors will see
    * **Answer Type** — Choose from Short Text, Paragraph, Multiple Choice (Radio), Multiple Choice (Checkbox), Star Rating (1-5), or File Upload
    * **Required toggle** — Make the question mandatory or optional

    <Frame>
      <img src="https://mintcdn.com/promo-d21ea471/CbMgZrn0xhoodcos/images/guides/forms/step-4-add-question.png?fit=max&auto=format&n=CbMgZrn0xhoodcos&q=85&s=d482768d818d8d185e0e7dcb27db239f" alt="Question with Star Rating type and Required toggle" width="1440" height="900" data-path="images/guides/forms/step-4-add-question.png" />
    </Frame>

    <Tip>
      Use **Star Rating** for quick satisfaction scores and **Paragraph** for open-ended feedback. **File Upload** is useful for collecting photos or documents.
    </Tip>
  </Step>

  <Step title="Add multiple choice options">
    When you select **Multiple Choice (Radio)** or **Multiple Choice (Checkbox)** as the answer type, an **Options** section appears. Type each option and click **+ Add Option** to add more.

    Radio questions allow ambassadors to select one answer. Checkbox questions allow multiple selections.

    <Frame>
      <img src="https://mintcdn.com/promo-d21ea471/CbMgZrn0xhoodcos/images/guides/forms/step-5-multiple-choice-options.png?fit=max&auto=format&n=CbMgZrn0xhoodcos&q=85&s=7bf1cb2652dee314588e1bc9d80cf979" alt="Multiple choice question with options" width="1440" height="900" data-path="images/guides/forms/step-5-multiple-choice-options.png" />
    </Frame>
  </Step>

  <Step title="Save the form">
    Once you've added all your questions, click **Create Form**. You'll be redirected to the Forms list where your new form appears at the top.

    <Frame>
      <img src="https://mintcdn.com/promo-d21ea471/CbMgZrn0xhoodcos/images/guides/forms/step-6-create-form-success.png?fit=max&auto=format&n=CbMgZrn0xhoodcos&q=85&s=cd4622c7bbe23f04d70c8c767c4f51f7" alt="Form created successfully" width="1440" height="900" data-path="images/guides/forms/step-6-create-form-success.png" />
    </Frame>
  </Step>
</Steps>

## Managing forms

<Steps>
  <Step title="Edit a form">
    Click any form card to open the form builder. You can modify the form name, description, and all questions. Use the drag handles to reorder questions. Click **Save Form** when done.

    <Frame>
      <img src="https://mintcdn.com/promo-d21ea471/CbMgZrn0xhoodcos/images/guides/forms/step-7-edit-form.png?fit=max&auto=format&n=CbMgZrn0xhoodcos&q=85&s=946d788f838ec47e4bf10f991a0b329d" alt="Edit form page" width="1440" height="900" data-path="images/guides/forms/step-7-edit-form.png" />
    </Frame>
  </Step>

  <Step title="Duplicate or archive a form">
    Click the **three-dot menu** on any form card to access quick actions:

    * **Edit** — Open the form builder
    * **Duplicate** — Create a copy of the form with all its questions
    * **Archive** — Remove the form from your active list

    You can also archive a form from the edit page using the **Archive Form** button.

    <Frame>
      <img src="https://mintcdn.com/promo-d21ea471/CbMgZrn0xhoodcos/images/guides/forms/step-8-duplicate-form.png?fit=max&auto=format&n=CbMgZrn0xhoodcos&q=85&s=8f353ebaa6bbe2272ffafab08357a8d5" alt="Form actions dropdown" width="1440" height="900" data-path="images/guides/forms/step-8-duplicate-form.png" />
    </Frame>
  </Step>
</Steps>

## Question types reference

| Type                       | Best for                      | Ambassador input       |
| -------------------------- | ----------------------------- | ---------------------- |
| Short Text                 | Names, short answers          | Single-line text field |
| Paragraph                  | Detailed feedback, comments   | Multi-line text area   |
| Multiple Choice (Radio)    | Single selection from options | Radio buttons          |
| Multiple Choice (Checkbox) | Multiple selections           | Checkboxes             |
| Star Rating (1-5)          | Satisfaction scores, ratings  | 1-5 star selector      |
| File Upload                | Photos, documents, receipts   | File picker            |

<Tip>
  Forms integrate with the **Tasks** feature. When creating a task, you can attach a form to collect structured responses from ambassadors alongside the task completion.
</Tip>

<Note>
  Duplicating a form copies all questions and options, making it easy to create variations of existing forms without starting from scratch.
</Note>
