Skip to main content
English

Quick Start: Set Up Tickets with /setup

Invite the bot, run /setup, pick a template and press Apply. The ticket panel is live as soon as the wizard finishes. For the same path with a picture of each Discord message, see Your first ticket panel.

New to ticket systems? How to set up a ticket system in Discord explains the choices first; this page is the click-by-click.

Which Ticket Tool is this?

This is Ticket Tool (ticket-tool.app, dashboard at dash.ticket-tool.app). Other Discord bots have similar names, so commands and settings from guides elsewhere may not match these docs. How we compare

Before you start

You need Manage Server (or Administrator) in the Discord server. Discord asks for it to add a bot, and /setup only shows for members who have it.

1. Add the bot

Select your server, authorize the bot, and keep the requested permissions enabled. Ticket Tool needs them to create private tickets and post the panel. Adding the Bot explains each permission.

2. Run the setup wizard

In Discord, run:

/setup

Press Let's Go!, then:

  1. Choose a starting point. Pick General support, Community, Game server, or Store or commissions.
  2. Check the preview. It lists the ticket categories the template creates and the channel the panel goes to. Use Put the panel somewhere else to pick another channel. Nothing is created until you apply.
  3. Press Apply.
  4. Choose channels or threads. The bot asks how tickets should appear: Channels gives each ticket its own channel, and Threads opens each one as a private thread in one channel. It then creates the categories and posts the panel. You can change this per category later. See Thread Tickets.

The template makes every role with Manage Server a support role, so those members see each new ticket. To add a dedicated staff role, press Set a staff role on the result, which opens the dashboard's Permissions page.

If another ticket bot is already set up in the server, the wizard offers to recreate its categories and panel instead. See Switch from another ticket bot.

To choose everything yourself, select Set it up manually instead. The wizard then asks for admin roles, support roles, a first ticket category and the panel channel.

3. Test a ticket

After the wizard posts the panel:

  1. Open the panel channel.
  2. Click the ticket button.
  3. Confirm a private ticket opens, as a channel or as a thread in your ticket channel.
  4. Confirm the ticket creator and your staff can see it.
  5. Send a reply, close the ticket, and check that logs or transcripts are posted where expected.

Members can also open a ticket from any channel with /new, which offers the same options as your panel.

Dashboard setup

Added the bot from our website? Your browser opens the server's dashboard with four templates to pick from. Choose one and press its Set up button (for example Set up General support) to create the categories and post the panel in one click, or choose Start from scratch.

Prefer the web dashboard?

Create a category under Categories, create a panel under Panels, then deploy the saved panel from Discord with:

/setup-panel

The dashboard saves panel configuration; /setup-panel posts it to a Discord channel.

What to configure next

GoalRead
Add more ticket typesTicket Categories
Customize the panel messageTicket Panels
Give staff the right accessPermissions
Change welcome text and embedsCustom Messages
Automate intake or routingSupport Flows
Find the IDs settings ask forFind Your Discord ID
Let an AI agent configure itSet up with an AI agent

Troubleshooting

ProblemCheck
/setup does not appearYou have Manage Server, and the channel allows Use Application Commands.
Apply asks for permissionsGrant the bot Manage Channels and Manage Roles in Server Settings, then press Apply again.
Bot cannot post the panelIt can View Channel, Send Messages, and Embed Links in the target channel.
Ticket channel not createdIt can Manage Channels in the target Discord category.
Ticket thread not createdSee Thread Tickets troubleshooting.
Staff cannot see ticketsTheir role is a Support Role on the category. A template only adds roles with Manage Server.
Dashboard server is missingYou are logged in with the Discord account that manages that server.

Common questions

How long does Ticket Tool setup take?
About five minutes: add the bot, run /setup, pick a template and press Apply.
Can I run /setup again?
Yes. If setup is finished, /setup offers Restart Setup. Applying a template again skips any category whose name already exists, and creates the rest.
Who can run /setup?
Members with Manage Server or Administrator. Discord hides the command from everyone else.
How do I post the panel in another channel?
Use Put the panel somewhere else in the preview, or send a saved panel from the dashboard's Panels page or with /setup-panel.