# Discord

Post each form submission to a Discord channel with mentions. Connect the Formstep bot, write your own message with answers in it, and send a test first.

## What you get

Formstep posts each submission to the channel as it arrives. It connects as a bot, so you do not copy webhook URLs or IDs. Discord posts only new submissions. For past data, use [Google Sheets](https://formstep.io/docs/integrations/google-sheets/) or [Notion](https://formstep.io/docs/integrations/notion/).

## Connect Discord

1. **Open the integration**

   Click Integrations in the form's top bar, pick Discord, then click **Connect Discord account**.

2. **Server and channel**

   In the Discord window, authorize the Formstep bot, then pick the server. If the bot is not in it yet, click **Invite bot** and refresh. The channel list shows the text and announcement channels the bot can post in, grouped by category.

3. **Message**

   Type @ to insert field values, submission metadata such as PDF Link, Discord users, or roles. Use bold, italic, or links.

4. **Unfinished drafts (optional)**

   Under **More options**, on Pro and Business, pick an idle window and write a message for unfinished drafts. Leave it Off to skip.

5. **Turn it on**

   Click **Turn on Discord**, then **Send test** to post a preview. Placeholders show as \[Question title], and no real answers are sent.

## Unfinished drafts

On Pro and Business, Discord can also post a separate message for [unfinished drafts](https://formstep.io/docs/submissions-analytics/partial-submissions/#unfinished-drafts) from the share link, set under **More options** › **Unfinished drafts**.

## Limits

- A message can be up to 2,000 characters. Formstep shortens a longer one.

- You can mention users and roles. `@everyone` and `@here` do not work, so mention a role instead.

- Formstep posts to text and announcement channels only.

- Bold, italic, strikethrough, inline code and links work; underline does not.

## When something goes wrong

**The bot isn't in my server**

Click **Invite bot** during setup. Pick the server and confirm the permissions. Then go back to Formstep and refresh the server list.

**The integration stopped posting**

Usually the bot was removed from the server, lost its permissions for the channel, or the channel was deleted. Open the integration in the form’s Integrations dialog: **Recent events** shows the error. Invite the bot again or reconnect, or delete the integration and set it up again. See [Health and monitoring](https://formstep.io/docs/integrations/health-monitoring/).

## FAQ

**How do I change which channel messages go to?**

You cannot change the server or channel after setup. Delete the integration and create a new one for the new channel.

**Can I connect multiple Discord servers?**

Yes. Each integration posts to one server and one channel. Add one Discord integration per server to the same form.

**Can other workspace members see my Discord connection?**

Yes. Discord connections belong to the workspace. Any member can use any connected Discord account in an integration.

**What permissions does the Formstep bot need?**

View Channels, Send Messages, Send Messages in Threads, Create Public Threads and Embed Links. It does not ask for Mention Everyone, Read Message History, Administrator, or Manage Messages or Channels. To limit the bot to one channel, set channel permission overrides for the Formstep bot role in Discord.

**How do I remove the integration?**

Open Integrations, pick Discord under **On this form**, and choose **Delete integration** in the ⋯ menu. To remove the bot from your server too, open Server Settings, then Integrations, in Discord and remove Formstep.

## Next steps

[Slack](https://formstep.io/docs/integrations/slack/) — Post each submission to a Slack channel

[Custom webhooks](https://formstep.io/docs/integrations/webhooks/) — Send each submission to your own URL