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

# Build and Send Multi-Question Custom Forms in Discord

> Use Quarky's /form commands to build multi-question Discord forms with ratings, multiple choice, and free text — and collect structured member responses.

Quarky's Custom Forms feature lets you build multi-question forms that members complete inside a private Discord thread. You can mix question types — free text, ratings, yes/no, multiple choice, and more — and all submitted answers are sent to a logs channel you choose.

Like the ticket system, forms are built from two components:

* **Form panels** — define the questions, logs channel, and thread settings for a form
* **Form embeds** — the message posted in your server with buttons that open a form panel

## Question types

Custom Forms support the following question types:

| Type                       | Description                                                         | Additional parameters                                             |
| -------------------------- | ------------------------------------------------------------------- | ----------------------------------------------------------------- |
| Open Ended                 | Members respond with free-form text                                 | —                                                                 |
| Rating                     | Members rate something on a numeric scale                           | Minimum scale, maximum scale, input type (Buttons or Select Menu) |
| Yes/No                     | Members choose between Yes and No                                   | Input type (Buttons or Select Menu)                               |
| Multiple Choice (Single)   | Members choose one option from a list                               | Options, input type (Buttons or Select Menu)                      |
| Multiple Choice (Multiple) | Members choose one or more options from a list                      | Options, maximum choices                                          |
| Likert Scale               | Members respond on a scale from strongly disagree to strongly agree | Input type (Buttons or Select Menu)                               |

<Note>
  The question type list is updated as new types are added to Quarky.
</Note>

## Creating a form panel

<Steps>
  <Step>
    Begin by using `/form panel create` and give the panel a name.\
    ![](https://imgur.com/mkGjiC2.png)
  </Step>

  <Step>
    A setup wizard will open where you can configure the form questions, logs channel, and other settings.\
    ![](https://imgur.com/o6d8263.png)
  </Step>

  <Step>
    Click **Config** to set:

    * **Form Thread Name** — the private thread name created when users start the form
    * **Form Created Reply** — message sent when users click the form button
    * **Form Submitted Reply** — message sent when users finish submitting\
      ![](https://imgur.com/jeoC2dU.png)
  </Step>

  <Step>
    Select a **Logs Channel**, where all submissions for this panel will be sent.\
    ![](https://imgur.com/lvg5OLd.png)
  </Step>

  <Step>
    Click **Questions** to begin adding questions to your form.\
    ![](https://imgur.com/ql4AWvS.png)
  </Step>

  <Step>
    Click **Add Question** and choose the question type.\
    For this example, choose **Open Ended Question**.\
    ![](https://imgur.com/UxLLUyV.png)
  </Step>

  <Step>
    Click **Config** to write the question text and submit it.\
    ![](https://imgur.com/Kpz54bO.png)
  </Step>

  <Step>
    Add another question by clicking **Add Question**.\
    This time select **Rating Question** as the type and **Button** as the input type.\
    ![](https://imgur.com/Eqx6V6O.png)
  </Step>

  <Step>
    Click **Config** again and set the question details, including **Minimum Scale** and **Maximum Scale**, then submit.\
    ![](https://imgur.com/EdWFfZx.png)
  </Step>

  <Step>
    Add a third question by clicking **Add Question**.\
    Select **Yes/No Question** as the type and **Select Menu** as the input type.\
    ![](https://imgur.com/SotYAMR.png)
  </Step>

  <Step>
    Click **Config** to set the question text, then click **Submit**.\
    ![](https://imgur.com/eY8XEaq.png)
  </Step>

  <Step>
    After adding your three questions, you will see them listed.\
    Click **Save** to store the panel configuration.\
    ![](https://imgur.com/SAoSWfx.png)
  </Step>

  <Step>
    Once saved, you can return anytime to **Edit** or **Delete** the panel.\
    ![](https://imgur.com/eP7NprB.png)
  </Step>
</Steps>

## Creating a form embed

Once you have at least one form panel, create a form embed to post in your server.

<Steps>
  <Step>
    Now with the form panel done, run `/form embed create` and give it a name.\
    ![](https://imgur.com/bxjGVp4.png)
  </Step>

  <Step>
    The embed wizard will open, allowing you to configure the embed and manage button panels.\
    ![](https://imgur.com/szlzpdT.png)
  </Step>

  <Step>
    Click **Embed** and fill in the Title, Description, Hex Color, Footer, and Image. These are optional but recommended for clarity. Click **Submit** afterward.\
    ![](https://imgur.com/PwkaN8T.png)
  </Step>

  <Step>
    The embed preview will update according to the configuration you set.\
    ![](https://imgur.com/vgq4Z3f.png)
  </Step>

  <Step>
    To add button form panels, scroll down and click **Panels**.\
    ![](https://imgur.com/KYZgxNt.png)
  </Step>

  <Step>
    Click **Add Panel**.\
    ![](https://imgur.com/khvaB5U.png)
  </Step>

  <Step>
    Click **Button** and configure the button settings:

    | Setting      | Options                                      |
    | ------------ | -------------------------------------------- |
    | Button Label | Text shown on the button                     |
    | Button Color | `0` Grey · `1` Blurple · `2` Green · `3` Red |
    | Button Emoji | Emoji shown on the button                    |

    After filling these in, click **Submit**.\
    ![](https://imgur.com/JlBOig9.png)
  </Step>

  <Step>
    From the dropdown, select the **Form Panel** you created earlier (e.g., `panel`). Then click **Save**.\
    ![](https://imgur.com/T3mkcY9.png)
  </Step>

  <Step>
    After saving, you can now **Send**, **Edit**, or **Delete** the embed using the available buttons.\
    ![](https://imgur.com/obDxRKg.png)
  </Step>

  <Step>
    Click **Send** and choose the channel where the embed should be posted. The embed will appear there.\
    ![](https://imgur.com/5pnT1qx.png)
  </Step>

  <Step>
    When a user clicks the form button, a private thread will open where they can answer the form questions. Below is the first open-ended question.\
    ![](https://imgur.com/rVhwAGI.png)
  </Step>

  <Step>
    After answering the first question, the bot sends the second question as selectable rating buttons (1–10).\
    ![](https://imgur.com/YEAYXN9.png)
  </Step>

  <Step>
    After a rating is selected, the bot sends the third yes/no question.\
    ![](https://imgur.com/HK1Ubx2.png)
  </Step>

  <Step>
    Once all questions are answered, the bot posts the **Submitted Answers** in the private thread.\
    ![](https://imgur.com/5rlM175.png)
  </Step>

  <Step>
    The bot also posts the submitted answers to the **Logs Channel** you configured earlier.\
    ![](https://imgur.com/5zRzBQf.png)
  </Step>
</Steps>

When a member clicks a form button, Quarky opens a private thread and presents each question one at a time. Once the member answers all questions, the bot posts a summary in the thread and sends the full submission to the logs channel.

<Info>
  Each member can only submit a form once per embed message. If you post the same embed in a different channel, the member can submit once via that channel's button. This keeps submissions organized in the logs channel per embed.
</Info>

## Slash commands

### Panel commands

| Command                     | Description                                         |
| --------------------------- | --------------------------------------------------- |
| `/form panel create [name]` | Create a new form panel with the interactive wizard |
| `/form panel get [name]`    | View a form panel with Edit and Delete actions      |
| `/form panel list`          | List all saved form panel names                     |

### Embed commands

| Command                     | Description                                           |
| --------------------------- | ----------------------------------------------------- |
| `/form embed create [name]` | Create a new form embed with the interactive wizard   |
| `/form embed get [name]`    | View a form embed with Send, Edit, and Delete actions |
| `/form embed list`          | List all saved form embed names                       |
