Panel System
Panels are the heart of BetterTicket. A panel is a Discord embed message with a button (or dropdown) that users click to open a ticket. You can create as many panels as you need, each with its own settings, categories, staff roles, and appearance.
What is a Panel?
When BetterTicket posts a panel to a channel, Discord users see an embed message with a button (e.g., "Open a Ticket"). Clicking that button triggers BetterTicket to:
- Create a new private channel (or thread, for Thread-Style panels)
- Set the correct permissions so only the opener and support staff can see it
- Post the Ticket Message embed inside the new channel
- If a form is configured, show a modal asking the user to fill in details first
Creating a Panel
- 1Go to Dashboard → Panel Configs in the left sidebar.
- 2Click + New Panel.
- 3Fill in the panel settings (see field reference below).
- 4Click Save. The panel is now ready to be posted or attached to another panel.
Panel Fields Reference
General Settings
| Field | Description |
|---|---|
| Panel Name | Internal name. Only visible in the dashboard. Used to identify this panel when using /ticket panel. |
| Ticket Name Template | Format for the ticket channel name. Supports variables: {author.name}, {ticket.count}, {panel.name}, {date}, etc. |
| Ticket Category | The Discord category where new ticket channels are created. Must exist in your server. |
| Closed Category | If set, closed tickets move here instead of being deleted. Leave empty to delete on close. |
| Support Team Roles | Discord roles that have staff access to all tickets from this panel. Multiple roles allowed. |
| Additional Roles | Additional Discord roles that receive read-only or specific access to tickets (configurable in Permissions). |
| Max Open Tickets (per user) | Limit how many tickets a single user can have open from this panel at once. See Limits. |
Panel Embed Builder
The Panel Embed is the Discord message that users see in the channel. It contains the "Create Ticket" button. Click Edit Panel Embed to open the embed builder.
| Embed Field | Description |
|---|---|
| Author Name | Small text above the title. Optional. |
| Author Icon | Tiny icon shown next to the author name. Use an image URL. |
| Title | The large bold title text of the embed. |
| Body / Description | The main paragraph text. Supports Discord markdown and variables like {server.name}. |
| Color | The left-side accent color. Use a hex code (e.g., #00BFFF). Can be a shared color consistent with your branding. |
| Thumbnail | Small image shown in the top-right corner of the embed. Use an image URL. |
| Image | Large image shown at the bottom of the embed. Use an image URL. |
| Footer Text | Small text at the bottom of the embed. |
| Footer Icon | Tiny icon shown next to the footer text. Use an image URL. |
| Fields | Up to 25 additional inline or block fields. Each has a name and value. |
| Multiple Embeds | You can add multiple embed blocks to a single panel message for a richer layout. |
Button Settings
| Field | Description |
|---|---|
| Button Label | Text displayed on the "Create Ticket" button. Max 80 characters. |
| Button Emoji | Optional emoji on the button. Use any standard emoji (e.g., 🎫) or paste a custom emoji from your server directly into the field. |
| Buttons Per Row | How many buttons to display per row (1–5). Useful when you have multiple panels attached together. |
Link Buttons
You can add URL link buttons alongside the Create Ticket button. These don't create tickets — they open a URL in the user's browser. Perfect for linking to a website, pricing page, or FAQ.
- 1In your panel settings, find the Link Buttons section.
- 2Click + Add Link Button.
- 3Set the Label, optional Emoji, and URL.
- 4Save. The link button will appear alongside the ticket creation button.
Attaching Panels (Multi-Panel Setup)
You can attach multiple panels to a single parent panel, so all buttons appear in one Discord message. This is useful for having "General Support", "Purchase Help", and "Bug Report" as separate buttons in one embed.
- 1Create all the panels you want to combine (e.g., "Support Panel", "Sales Panel").
- 2Open the parent panel (the one you'll post to the channel) and find Attached Panels.
- 3Select the panels to attach. Their "Create Ticket" buttons will be added to the parent's message.
- 4Post the parent panel using the dashboard Send button or
/ticket panel.
Tip: Each attached sub-panel still uses its own settings (category, support roles, messages, etc.). Only the embed from the parent panel is shown; sub-panel embeds are hidden when attached.
Dropdown / Select Menu Panels Premium
Instead of individual buttons, Premium users can configure a panel to show a select menu dropdown. Users pick from a list of options instead of clicking multiple buttons. This is cleaner when you have many ticket types.
- 1In your panel settings, enable Select Menu / Dropdown Mode.
- 2Set the Placeholder Text — the grayed-out text shown in the dropdown before a selection (e.g., "Select a topic...").
- 3Configure each dropdown item: set a Label, Description, and optional Emoji for each option.
- 4Each dropdown item corresponds to an attached sub-panel. Selecting an item opens a ticket using that sub-panel's settings.
Dashboard Actions: Send, Update & Clone
Important: Saving changes to your panel in the dashboard does not automatically update the Discord message already posted in your server. The dashboard is your configuration — the live Discord message is a separate snapshot. You must use Send (to post a fresh message) or Update (to edit the existing message in-place) to push your changes to Discord.
Send — Post a Panel to a Channel
Use Send to post your panel to a Discord channel for the first time, or to repost it after deleting the old message.
Via Dashboard
- 1Open the panel settings and scroll to the Send Panel section.
- 2Select the Discord channel you want to post to from the dropdown.
- 3Click Send. BetterTicket posts the embed immediately and the button becomes active for your members.
Via Slash Command
/ticket panel panel:My Panel Name channel:#support
Tip: If you've already posted a panel and only want to update its appearance, use Update instead of deleting and resending — it edits the message in-place so your members won't see any disruption.
Update — Push Dashboard Changes to Discord
After editing your panel's embed (title, description, color, image, etc.) in the dashboard, use Update to apply those changes to the message already posted in your Discord server. The message is edited in-place — no deletion, no repost, no loss of ticket button functionality.
- 1In the panel settings, scroll to the Update Panel Message section.
- 2Paste the Discord Message Link of the existing panel message. To get this: right-click the panel message in Discord → Copy Message Link.
- 3Click Update. The embed is edited in-place in your Discord channel.
Alternatively, if you don't have a message link, enter the Channel ID and Message ID separately — both can be copied from Discord with Developer Mode enabled.
Note: You can only update messages that BetterTicket originally posted. If the message was sent by a different bot or a user, the update will fail. In that case, delete the old message manually and use Send to post a fresh one.
Clone — Duplicate a Panel
Use Clone Panel to create an exact copy of an existing panel with all of its settings preserved — embed design, support roles, categories, messages, buttons, and more. The clone is saved as a new independent panel, so any edits you make to it won't affect the original.
This is useful when you want to create a similar panel for a different team or ticket type without building it from scratch.
- 1Open the panel you want to duplicate.
- 2Click the Clone Panel button at the top of the panel settings page.
- 3A new panel is created. Rename it and adjust any settings as needed.
- 4Use Send to post the cloned panel to a channel when it's ready.
Thread-Style Panels Premium
Premium users can enable Thread-Style mode on a panel, which creates a private thread instead of a full channel. See the Thread-Style Tickets documentation for full details.
BETTERTICKET