Panels and categories are the two things you build your ticket system out of. A panel is the message members click. A category decides who gets pinged and how that ticket behaves. Understand these two and you understand OnyxBot tickets.
Panels
A panel is a published message members use to open tickets, designed in the panel builder from stackable blocks with a live preview:
- Text blocks with full markdown: headings, bold, lists, small
-#subtext, and your server's custom emojis. - Image blocks (up to 10 images shown as a gallery) and separators for spacing.
- Categories blocks in three display modes: a list with each category's emoji, name, description, and an open button on its own row (the default), a compact button grid, or a dropdown. You can use several categories blocks and split categories between them under your own headings.
- An optional accent color on the panel's left edge, and the channel it publishes to. Republish after edits and the bot updates the message in place.
The builder shows Discord's real limits as you work (40 components and 4,000 characters of text per message) and stops you from exceeding them.
Categories
Each category is a kind of ticket, with its own behavior:
- Name and emoji. What members see on the panel button or dropdown. The emoji picker includes standard emojis and your server's own custom emojis.
- Staff roles. Who gets pinged on escalation and can see these tickets.
- Intake form. Up to five questions answered before the ticket opens. See intake forms.
- AI answering. On by default; switch it off where you always want humans first. See how the AI works inside tickets.
- Welcome message. Replace the default greeting with your own copy.
- Channel or thread. Tickets open as private channels by default, or private threads if you prefer no channel clutter.
- Naming template. For example
ticket-{counter}, with{username}and{category}available. - Auto-close hours. Close quiet tickets automatically. See auto-close and working hours.
Settings that apply to every category
A few things are set once for the whole server on Tickets, then Settings, not per category:
- Open tickets per member. How many tickets one member can have open at once across all categories: 1, 2, 3, 4, 5, or 10. A slot frees the moment a ticket closes, and there are no time cooldowns.
- Transcript access and retention, working hours, and guild-wide staff roles. See the articles on each.
Limits
Free includes 1 panel and 5 categories. Pro removes both limits.