Back to Articles
Keystone Docs9 min read

Tickets

The Tickets feature gives members a button panel to open private support tickets. Each ticket creates two linked spaces: a private channel for the conversation between the reporter and your staff, and a forum post in a staff-only channel for internal discussion and record-keeping. Forum tags track ticket status and type at a glance.

What makes it different

  • Dual-surface design. A private conversation channel for the reporter, and a separate staff forum post for internal discussion. Staff can coordinate without the reporter seeing it.
  • Full control panel. Claim, unclaim, assign, resolve, reopen, close, add a member, or rename a ticket, all from buttons on the forum post.
  • Status and type tags. The forum view shows Open, Claimed, Resolved, and Closed tags alongside ticket type, giving staff the ability to filter and prioritize.
  • Custom types and panels (premium). Build your own ticket types with custom modal fields and deploy multiple panels beyond the three built-in types.

Setup

setup → post panel → members open tickets → staff work the queue

Run /tickets setup to configure the category tickets are created under, your staff-only forum channel, a log channel, and the ticket-staff role that gets access to every reporter channel. Then run /tickets panel in whichever channel should display the ticket button panel.

Members click a button to open a ticket. This creates a private channel for them and a matching forum post for your staff, tagged Open. Staff work the ticket using the buttons on the forum post.

Commands

/tickets setup - Configure the ticket category, staff forum, log channel, and staff role(s). Server owner only.

/tickets panel - Post the ticket button panel in the current channel. Requires setup to be complete.

Premium commands

/tickets panels - Build and deploy custom ticket panels for custom ticket types.

/tickets types - Build custom ticket types with your own modal fields.

Troubleshooting

  • Panel won't post: confirm /tickets setup has been completed and the bot has permission to send messages in the channel.
  • Ticket channels aren't being created: check that the configured category has the correct permission setup and the bot has Manage Channels there.
  • Forum post missing tags: confirm the bot has Manage Channels permission in the staff forum so it can provision status and type tags.
  • Old ticket data missing: ticket records are anonymized 30 days after closing.
  • Custom types or panels locked: these are premium features. An active subscription is required to use /tickets types and /tickets panels.

Related topics:
ticketssupport tickets
Tickets | .Donuts' Discord Support