Servers and permissions

Register the Discord servers your bot uses, then test that ticket channels are private and visible to the right staff. One registered server is enough to run Modmail.

Choose your serversCopy Anchor Link

Your bot's Servers page has three slots, with one server per slot.

Tickets open in the first registered server the bot can reach, normally the main server. If it isn't available, the bot tries the other registered servers. Transcript channels can be in any registered server, so you can keep records in a separate staff server.

Register a serverCopy Anchor Link

Whitelisting connects a server to one of your bot's slots.

1. Open your group in the dashboard, select your bot, then open Servers.
2. If needed, select Invite bot and finish Discord's authorization.
3. Select Check servers until the server appears.
4. On its row, select Whitelist.
5. Choose Main server, Staff server, or Support server.
6. If the slot is already filled, review and confirm the replacement.

The server moves to Whitelisted with a badge naming its slot.

Give the bot the permissions it needsCopy Anchor Link

The dashboard's invite link requests Administrator. This gives your bot permission to create private ticket channels, manage channel access, send messages and transcripts, and create roles during setup.

If the bot was invited with fewer permissions and tickets aren't working, use the dashboard invite link to authorize the requested permissions.

Check who can see ticketsCopy Anchor Link

Members talk to the bot in DMs; they don't join the staff ticket channel. For each new channel, Modmail denies View Channel to @everyone and gives the configured staff roles permission to view, send messages, read history, send files, and embed links. Discord server owners and administrators retain access through Discord's own permissions.

New channels use a ticketnumber-username name and a two-second slow mode. Test access before launch:

1. Send your bot a direct message and finish the ticket prompts.
2. Find the new channel under the configured Discord category.
3. Ask a teammate with the staff role to confirm they can see it.
4. Confirm that a regular member can't see the channel.
5. Close the test ticket with /modmail close.

If staff can't see it, check Staff roles on Categories, then open a new test ticket after saving the correction.

If members can't open ticketsCopy Anchor Link

An incomplete setup or missing registered server produces a message that tickets aren't available because setup isn't complete. If registered servers can't be reached, members are told the ticket server is unavailable.

Open Servers and confirm that at least your main server is whitelisted and your bot has joined it. Finish ticket routing in setup, then message the bot again to check that the menu appears.

Next stepsCopy Anchor Link

Review routing and transcripts or learn how to work in a ticket channel.