Forms · Docs

Ask members questions on the web or on Discord, then see every answer and the totals in the dashboard.

A form is a list of questions for your members. Use one for staff applications, appeals, event sign-ups or feedback.

Members can answer in two places:

On the web. Every form has a short link, like ccbot.app/f/aB3x9KqZ. Members log in with Discord and fill it in.
On Discord. A command starts the form. The bot opens a private thread and asks the questions one at a time.

Make a form#

Open Forms on the dashboard and press New form, or pick a ready-made one.
Add questions with Add question. Drag them to change the order.
Click a question to edit it. The preview shows how it looks on the web and on Discord.
Open Settings to choose the rules (see below).
Press Save. Open Share to copy the link.

Question types#

Type	What members do
Short text, Paragraph	Type an answer
Number, Email, Link, Date	Type an answer. The bot checks the format. Dates can have an earliest and latest day, and on Discord can be typed like `2 Feb 1980`
Date and time	Picked in your server's time zone (Settings → Timezone), shown on the form. On Discord, type it like `2026-10-26 17:00` or `tomorrow 5pm`. Answers show in each viewer's own time
Single choice, Multiple choice	Pick from your options
Yes / No, Rating	Press a button
Member, Role, Channel	Pick from the server
File upload	Attach a file (premium)
Info text	Read it, then continue
Page break	Starts a new page on the web. Discord asks one question at a time anyway

Start it on Discord#

Put this in a slash command's script:

python

await start_form("staff-application")

Use the Form ID from the form's Settings. The command replies with a link to the member's thread, following the command's own settings. Opening the thread takes a few seconds, so the command must answer Discord first:

Show thinking… on (the default): nothing else to do. Turn on Only the user sees the reply to keep the link private.
Show thinking… off: your script answers first and picks private or public itself:

python

await defer_response(ephemeral=True)
await start_form("staff-application")

Automations can do the same with the Start a form block.

How the thread works:

Only the member, the bot and moderators with Manage Threads can see it.
A header message stays at the top with a Cancel button. The bot asks one question at a time below it, and removes each answered question and the member's reply, so the thread stays clean.
The bot asks one question at a time. Typed answers are checked. 3 wrong answers in a row end the form, and the member starts again.
At the end the member sees all their answers and presses Submit or Edit an answer.
10 minutes with no answer ends the form.
The thread is deleted 30 seconds after the form ends.

Tip

Pick a Discord threads channel in Settings, for example #applications. Members need View Channel and Send Messages in Threads there. The bot needs Manage Messages to clear answers as it goes. The dashboard checks this and can fix it for you.

Settings#

Answers per member: one only, as many as they like, or a new answer replaces the old one.
Deadline and Max answers in total: after either, the form stops taking answers.
Post each answer: the bot posts every new answer to a channel you pick.
Roles after sending: give or remove roles when a member sends the form.

See the answers#

Open a form's Answers:

Summary shows a bar for each option with its percent, rating averages, number ranges and the latest text answers.
Each answer lists every member's answers. Click one to see it all, or delete it.
Export to Excel downloads everything (premium).

Limits#

	Free	Starter	Basic	Advanced
Forms	3	15	50	200
Questions per form	10	25	50	50
Answers per month	100	2,000	10,000	50,000
File upload questions	No	Yes	Yes	Yes
Excel export	No	Yes	Yes	Yes

Uploaded files count toward your server's storage on the Files page. If a plan ends, forms over the limit turn off, and file questions are skipped until you upgrade again. Nothing is deleted.

A form is a list of questions for your members. Use one for staff applications, appeals, event sign-ups or feedback.

Members can answer in two places:

On the web. Every form has a short link, like ccbot.app/f/aB3x9KqZ. Members log in with Discord and fill it in.
On Discord. A command starts the form. The bot opens a private thread and asks the questions one at a time.

Make a form#

Open Forms on the dashboard and press New form, or pick a ready-made one.
Add questions with Add question. Drag them to change the order.
Click a question to edit it. The preview shows how it looks on the web and on Discord.
Open Settings to choose the rules (see below).
Press Save. Open Share to copy the link.

Question types#

Type	What members do
Short text, Paragraph	Type an answer
Number, Email, Link, Date	Type an answer. The bot checks the format. Dates can have an earliest and latest day, and on Discord can be typed like `2 Feb 1980`
Date and time	Picked in your server's time zone (Settings → Timezone), shown on the form. On Discord, type it like `2026-10-26 17:00` or `tomorrow 5pm`. Answers show in each viewer's own time
Single choice, Multiple choice	Pick from your options
Yes / No, Rating	Press a button
Member, Role, Channel	Pick from the server
File upload	Attach a file (premium)
Info text	Read it, then continue
Page break	Starts a new page on the web. Discord asks one question at a time anyway

Start it on Discord#

Put this in a slash command's script:

python

await start_form("staff-application")

Show thinking… on (the default): nothing else to do. Turn on Only the user sees the reply to keep the link private.
Show thinking… off: your script answers first and picks private or public itself:

python

await defer_response(ephemeral=True)
await start_form("staff-application")

Automations can do the same with the Start a form block.

How the thread works:

Only the member, the bot and moderators with Manage Threads can see it.
A header message stays at the top with a Cancel button. The bot asks one question at a time below it, and removes each answered question and the member's reply, so the thread stays clean.
The bot asks one question at a time. Typed answers are checked. 3 wrong answers in a row end the form, and the member starts again.
At the end the member sees all their answers and presses Submit or Edit an answer.
10 minutes with no answer ends the form.
The thread is deleted 30 seconds after the form ends.

Tip

Settings#

Answers per member: one only, as many as they like, or a new answer replaces the old one.
Deadline and Max answers in total: after either, the form stops taking answers.
Post each answer: the bot posts every new answer to a channel you pick.
Roles after sending: give or remove roles when a member sends the form.

See the answers#

Open a form's Answers:

Summary shows a bar for each option with its percent, rating averages, number ranges and the latest text answers.
Each answer lists every member's answers. Click one to see it all, or delete it.
Export to Excel downloads everything (premium).

Limits#

	Free	Starter	Basic	Advanced
Forms	3	15	50	200
Questions per form	10	25	50	50
Answers per month	100	2,000	10,000	50,000
File upload questions	No	Yes	Yes	Yes
Excel export	No	Yes	Yes	Yes

Uploaded files count toward your server's storage on the Files page. If a plan ends, forms over the limit turn off, and file questions are skipped until you upgrade again. Nothing is deleted.