---
description: Button form will help you to create forms on Discord.
---

# Button Form

![Sugggestion Form using Button Form](https://2663464464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mh-NqscL076EyFAnMlW%2Fuploads%2FhValNTjoPgBiAX7VEBCx%2FScreen%20Shot%202022-04-07%20at%2010.33.16%20AM.png?alt=media\&token=37fa13a6-0c19-42e0-9ce3-feeac91ffe09)

## Behind Story

Many times we wanted to create a form to collect some data from our community and that was very difficult to do until now. With our Button Form feature you can create beautiful Forms and pair them with multiple actions to create the Forms of our dreams.

## Uses Cases

* To create suggestion system.
* To create support/ticket system.
* To create form application.
* To create questionaries.
* And more..

## /button create form

Add button form to bot existing messages.

![/button create form](https://2663464464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mh-NqscL076EyFAnMlW%2Fuploads%2Fx0mWBVI7sfKdZ9d3j8Uk%2FScreen%20Shot%202022-04-07%20at%2010.32.32%20AM.png?alt=media\&token=26063139-972d-4959-9f88-97bed6f7752d)

![Button Form Result](https://2663464464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mh-NqscL076EyFAnMlW%2Fuploads%2F2KYP9QTCh4HcUnT23FIJ%2FScreen%20Shot%202022-04-07%20at%2010.32.52%20AM.png?alt=media\&token=5e40e6e5-1f02-4dcb-8078-27172cbcdffb)

![Form Window](https://2663464464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mh-NqscL076EyFAnMlW%2Fuploads%2FHRVwJWvLBw3qQnYgVN1c%2FScreen%20Shot%202022-04-07%20at%2010.33.16%20AM.jpg?alt=media\&token=3c24b542-0bbb-44a3-b647-8546961d8c2d)

![Custom Response Message](https://2663464464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mh-NqscL076EyFAnMlW%2Fuploads%2FNOU4OeIuS13a1co11Z73%2FScreen%20Shot%202022-04-07%20at%2010.59.34%20AM.png?alt=media\&token=73c5cc3a-60e9-4133-b824-c0587d5c21d8)

![Submitted Form](https://2663464464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mh-NqscL076EyFAnMlW%2Fuploads%2FLZSPfZJjJSsWQ5XwHnxv%2FScreen%20Shot%202022-04-07%20at%2010.33.39%20AM.jpg?alt=media\&token=2998cd1d-03d5-4931-a9a3-cff631b34ed9)

### Command

| Usage                                                                                                                                                                                                                                                  |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| /button create form \[message\_link] \[label] \[channel\_log] \[form\_title] \[first\_question] (additional questions) (box styles) (counter) (reactions) (discussion\_mode) (mention) (emoji) (color) (role) (role\_mode) (image) (response\_message) |

| Example                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| /button create form `message_link:`[`https://discord.com/channels/940682906983075891/941053628905586838/941403726378332160`](https://discord.com/channels/940682906983075891/941053628905586838/941403726378332160) `label: Create Suggestion` `channel_log: #suggestions-log` `form_title: Suggestion` `first_question: Message` `first_question_box_style: Required Long Box` `counter: ON` `reactions:` :thumbsup:, :thumbsdown: `discussion_mode: Thread with Form Title as name` response\_message: `Thank  you for your suggestion!` |

{% hint style="danger" %}
<mark style="color:red;">**Important:**</mark> By default only members with **Manage Server** can use this command. See [Discord Slash Command Permissions](../../moderator-features/settings-features/discord-slash-command-permissions) to customize it.
{% endhint %}

{% hint style="warning" %}
<mark style="color:orange;">**Check this:**</mark> \[] is a required command option, () is an optional command option.
{% endhint %}

### Command Options

| Option                                          | Description                                                                                           |
| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| message\_link                                   | Specify message by the link or ID                                                                     |
| label                                           | Custom button label                                                                                   |
| channel\_log                                    | Select channel where the bot will log submitted form                                                  |
| form\_title                                     | Specify Form Title                                                                                    |
| question                                        | Add up to 5 questions                                                                                 |
| question\_box\_style \<Required Short Box>      | Set question box style to required with short box style                                               |
| question\_box\_style \<Optional Short Box>      | Set question box style to optional with short box style                                               |
| question\_box\_style \<Required Long Box>       | Set question box style to required with long box style                                                |
| question\_box\_style \<Optional Long Box>       | Set question box style to optional with long box style                                                |
| counter \<OFF>                                  | To turn OFF counter mode                                                                              |
| counter \<ON>                                   | To turn ON counter mode (Default)                                                                     |
| reactions                                       | To add reactions on submitted form                                                                    |
| discussion\_mode \<OFF>                         | To turn OFF discussion mode (Default)                                                                 |
| discussion\_mode \<Thread>                      | To turn ON automatically creating a thread                                                            |
| discussion\_mode \<Thread & Add Author>         | To turn ON automatically creating a thread and add author to the thread                               |
| discussion\_mode \<Text channel>                | To turn ON automatically creating a text channel                                                      |
| discussion\_mode \<Text channel & Add Author>   | To turn ON automatically creating a text channel and add author to the text channel                   |
| discussion\_mode \<Ticket channel & Add Author> | To turn ON automatically creating a text channel with close button and add author to the text channel |
| discussion\_name \<Form Title>                  | Use form title as the discussion name                                                                 |
| discussion\_name <1st Question Answer>          | Use 1st Question Answer as the discussion name                                                        |
| discussion\_name \<Author Name>                 | Use author name as the discussion name                                                                |
| discussion\_name \<Title + Author Name>         | Use form title and author name as the discussion name                                                 |
| role\_mention                                   | Role to mention when discussion mode is ON                                                            |
| emoji                                           | Add emoji to your button label                                                                        |
| color \<Gray>                                   | Choose gray color for your button (Default)                                                           |
| color \<Blue>                                   | Choose blue color for your button                                                                     |
| color \<Green>                                  | Choose green color for your button                                                                    |
| color \<Red>                                    | Choose red color for your button                                                                      |
| role                                            | Add role to the button                                                                                |
| role\_mode \<Add Only>                          | Set role mode to add role only                                                                        |
| role\_mode \<Remove Only>                       | Set role mode to remove role only                                                                     |
| image                                           | Set custom image for your submitted form                                                              |
| response\_message                               | Set custom response message when form is submitted                                                    |

{% hint style="info" %}
<mark style="color:blue;">**Good to know:**</mark> Go to [variables](../../../getting-started/variables#what-is-variables) page to learn on how to design your message using variables.
{% endhint %}

{% hint style="info" %}
<mark style="color:blue;">**Good to know:**</mark> You also can use [discord markdown](https://support.discord.com/hc/en-us/articles/210298617-Markdown-Text-101-Chat-Formatting-Bold-Italic-Underline-) to design your message.
{% endhint %}

{% hint style="success" %}
<mark style="color:green;">**Premium Benefit:**</mark> This feature has extra benefit for Premium Servers. For detail visit [Premium Page](../../premium).
{% endhint %}
