Configuration
Create and manage ticket categories — each with its own forum, questions, thread naming, messages, connector queries and auto-assignment.

A category is a ticket type — billing, tech support, a report, a purchase. Every ticket arrives pre-labelled and complete because its category decides where it lands, what the member is asked first, how the thread is named, which messages the bot posts, and who picks it up.

You manage categories under Settings → Categories. Every change saves automatically.

New to the idea? Read Categories & inputs for the concept, then come back here for the how-to.

The page

  • The list on the left shows every category with its emoji, name and forum channel — or a No channel warning when none is set yet. Drag the handle (or use ↑/↓ on it) to reorder: the order here is the order on your creation panels. A search box filters the list.
  • The header shows the selected category. Click the emoji to change it, click the name to rename it inline, and use the … menu for Rename, Duplicate category, Move up / down and Delete category.
  • Six sections below hold the settings — Forum Selection, Setup Inputs, Connector Queries, Thread Naming, Messages, Auto-Assignment. On wide screens a Help column explains the open section.
  • The footer shows the save state: Changes save automatically, Saving…, Saved automatically · a moment ago. If a save fails, Clarify restores the last saved state and tells you.

Add, duplicate and delete

Create a category

Click New category at the bottom of the list. Give it a Name, pick an emoji, and choose a category to copy the configuration from — inputs, messages and settings start out as a copy of that one, so a new category is usable immediately.

Duplicate a category

… → Duplicate category creates " (copy)" with the same emoji and configuration.

Delete a category

… → Delete category, then confirm. Tickets already created in that category are kept. A server always keeps at least one category, so the last one cannot be deleted.

Escalation tiers and opening-hours schedules refer to categories. If you delete a category a tier uses, the escalation configuration reports it as missing the next time you save it; a schedule simply stops covering it.

Forum Selection

Every ticket of this category is created as a thread inside this forum channel — the place where your team works on it.

forumChannelId
select
Forum channel — only forum channels of this server are selectable. The bot needs permission to create threads there. Use Reload to fetch the current channel list from Discord (once every 20 seconds). Changing the forum later affects new tickets only; existing threads stay where they are.
Whether the customer's side of the ticket is a DM, a private thread or a channel is a server-wide choice — see Tickets & modes. The forum is your team's side, and it is only created while Mirror to internal forum is on.

Setup Inputs

The questions the member answers in a form before their ticket is created.

enabledInputs
select
Active inputs — pick up to 5 inputs; Discord shows at most five fields in one form, and any beyond that are dropped. The list mixes your own inputs with the ready-made ones an active integration offers (Stripe, Tebex, Patreon, connectors), marked Module. A category with no inputs skips the form and opens the ticket immediately.

Inputs are server-wide: create one once with Create new input, reuse it in every category that needs it, and edit it in one place. The Live Preview shows the form exactly as Discord will render it, titled with the category's name. Every input type, its options and its limits are documented on the Ticket inputs page.

The answers appear as fields on the ticket's opening card, and the first five are available as %tag_input_value_01% … %tag_input_value_05% in thread names and messages.

Connector Queries

Run your own data connector operations when a ticket in this category is created — an order lookup against your shop, a customer record from your CRM — and post the result as a card into the thread.

connectorBindings
list
Active queries — each query is a connector plus one of its lookup operations. For every input the operation declares you choose where the value comes from:
  • Ticket input — an answer from this category's form.
  • Opener's Discord ID, Opener's username, Opener's e-mail — data of the member who opened the ticket.
  • Fixed value — a constant, handy for a shop or environment id.
An operation without inputs runs automatically on every new ticket.

Queries run right after the ticket opens, in parallel, and never delay or block the ticket. A required query input that stays empty (for example an optional form field the member skipped) skips that query; a connector that is unavailable leaves a short notice instead of a card. Manage connectors takes you to the connector builder.

Thread Naming

Defines what the ticket thread is called. Variables are replaced with the ticket's data when it is created; the Live Preview shows the result.

threadName
text
Naming pattern — plain text plus variables. Click a variable chip to insert it at the cursor. Discord truncates thread names at 100 characters, so keep it short.
VariableBecomes
%user_name%The member who opened the ticket
%tag_name%The category's name
%created_at%When the ticket was created, in your server's timezone and date format
%tag_input_value_01% … %tag_input_value_05%The member's answers to the first five text inputs — practical for an order number in the title
Variables always start and end with %. Anything else appears exactly as written; a variable without a value is left out.

Messages

Four moments where the bot posts automatically. Each one uses a blueprint — a reusable message template. Editing a blueprint updates every category that uses it; Create New Blueprint makes one for this phase only, and the Live Preview shows the selected card.

enabledEmbedConfig.opening
blueprint
Welcome — Support Thread Opening. Posted automatically when the support thread is created in your forum: your team's first look at the ticket.
enabledEmbedConfig.started
blueprint
Support — Initial User Message. The first message the member receives immediately after creating a ticket. It carries their answers, the connector and payment lookups, and the Close and Assign buttons.
enabledEmbedConfig.closed
blueprint
Closing — Ticket Closure Message. Shown once the ticket has been closed, with the Reopen, Transcript and (optionally) Feedback buttons.
enabledEmbedConfig.reopened
blueprint
Reopen — Ticket Reopened Message. Sent when a previously closed ticket is reopened by the member or your staff.

Variables available in these cards include %user_mention%, %user_avatar_url%, %ticket_id% and %tag_input_value_01% … %tag_input_value_05%. If a phase has no blueprint selected, Clarify falls back to your server's blueprint of that type, then to its built-in default.

Blueprints, the editor and every placeholder are covered in Cards & placeholders.

Auto-Assignment

Automatically assign new tickets of this category to a supporter — the strategy and the participating groups are chosen here, per category. The global rules (who may claim or assign, markers, DMs) live in the Assignment module.

assignment.strategy
radio
Distribution strategy — how a new ticket in this category picks a supporter. Default: Off.
  • Off — Manual claiming only — no auto-assignment.
  • Round-robin — Rotate through the available members.
  • FIFO — Longest-waiting supporter is next; returners queue at the back.
  • Least load — The supporter with the fewest open assigned tickets.
assignment.handledRoles
role-select
Handled groups — the support roles this strategy draws from. A member needs one of these roles to be auto-assigned, and to claim tickets, in this category. Empty means every support role.
assignment.excludedSupporters
select
Excluded supporters — individual members exempted from auto-assignment in this category. They can still claim manually.

Supporters who are marked Away on the assignment roster are skipped too. Auto-assignment is best-effort: when nobody is available, the ticket simply waits for a claim.

Categories and Discord forum tags

Categories that were imported from your forum's Discord tags during onboarding are those tags: renaming a tag or changing its emoji in Discord updates the category, and new tags on the forum appear as new categories. Categories you create in the dashboard are Clarify's own and are not created as Discord tags.

What's next

Ticket inputs

Every input type you can add to a category's form.

Data connectors

Build the lookups your connector queries run.

Panels

The clickable message members use to open a ticket.

Assignment

Claiming, markers and the roster behind auto-assignment.