Server Settings
Use Dashboard -> Settings for server-wide bot configuration. Changes are not auto-saved; after editing, use the unsaved changes bar at the bottom of the page to Reset or Save Changes.
Areas
| Area | What it controls | Notes |
|---|---|---|
| General | Bot nickname, timezone, default embed color, footer text, footer icon URL | Embed defaults can still be overridden per category. |
| Branding | Custom logo, accent color, bot avatar, and bot display name | Pro. Toggle Enable Custom Branding before editing. |
| Automation | Ticket creation cooldown, default SLA target, custom placeholders | SLA tracking is Pro. Cooldown and placeholders are server settings. |
| Localization | Custom bot text and button emoji | See the Localization guide. |
| Security | Audit logs, data and retention summary, permission checks | Use this area when debugging missing bot permissions. |
| Advanced | Import, export, and destructive reset tools | Export before using danger zone actions. |
Related server setup
API tokens and server-wide Twilio SMS setup live on Dashboard -> Integrations. Anonymous replies live on Dashboard -> Features, and the AI settings live on AI Control.
General
| Setting | Use it for | Limits and behavior |
|---|---|---|
| Bot Nickname | The bot's nickname in your server | Max 32 characters. Requires the bot to have permission to change its nickname. |
| Timezone | Transcript timestamps and scheduled behavior | Pick from the grouped timezone list or detect your browser timezone. |
| Default Embed Color | Embed sidebar color | Hex color, default #5865F2. |
| Footer Text | Optional footer on bot embeds | Leave blank for no footer. |
| Footer Icon URL | Small icon next to the footer | Must be an image URL. |
Branding
Custom branding is Pro. On Free and Community, the card shows an upgrade prompt.
| Setting | Use it for |
|---|---|
| Brand Logo URL | Logo for embed thumbnails and branded surfaces. |
| Brand Accent Color | Primary color for branded embeds. |
| Custom Bot Avatar URL | Avatar used for branded bot messages sent through webhooks. |
| Custom Bot Display Name | Display name used with the custom avatar, max 80 characters. |
Automation
| Setting | Use it for | Limits and behavior |
|---|---|---|
| Ticket Creation Cooldown | Minimum time between ticket creations per user | 0-3600 seconds. Default is 60 seconds. Set to 0 to disable. |
| Target Response Time | Default first-response SLA target | Pro. Range is 1-10,080 minutes. Categories can override it. |
| Custom Placeholders | Reusable variables in embeds and messages | Add a key and value, then use {placeholder.key}. |
SLA empty state
Leaving the SLA target empty falls back to a 15 minute default. It does not disable SLA tracking.
Common built-in placeholders:
| Variable | Meaning |
|---|---|
{user.username} |
Username |
{user.mention} |
Mentions the user |
{channel.name} |
Channel name |
{guild.name} |
Server name |
{ticket.number} |
Ticket number in automation flows |
{ticket.creator.username} |
Ticket creator username in automation flows |
{ticket.creator.mention} |
Mentions the ticket creator in automation flows |
See the Flows variable picker for the full list.
Localization
Localization changes the bot's user-facing text and button emoji for this server. It is free on every plan. The dedicated Localization guide covers starter language packs, the live preview, and import/export.
Security
| Tool | Shows or checks |
|---|---|
| Audit Logs | Recent administrative actions, actor, target, and timestamp. |
| Data & Retention | Stored tickets, transcripts, and the plan retention period. |
| Permission Checker | Bot permissions globally or in a specific channel. |
Use Permission Checker for issues such as missing Manage Channels when creating tickets, Manage Messages when pinning, or Send Messages in a target category.
Advanced
| Tool | What it does | Confirm with |
|---|---|---|
| Export Configuration | Downloads server configuration as JSON, including categories, panels, commands, flows, and settings. | No confirmation phrase. |
| Import Configuration | Uploads JSON configuration and merges it into the current server config. | Review the import summary before confirming. |
| Reset All Settings | Resets settings to defaults. Categories, panels, and other content remain. | Type RESET. |
| Delete Tickets & Transcripts | Permanently deletes all tickets and transcripts while preserving configuration. | Type DELETE ALL DATA. |
| Delete Server Configuration | Permanently deletes tickets, categories, panels, flows, knowledge base, commands, automation, and analytics. | Owner only; confirm with the server name. |
Danger zone
Destructive actions are permanent. Export the configuration first if you may need to restore the server setup later.
Integrations
API tokens and Twilio SMS are configured from Dashboard -> Integrations, not the Settings tabs.
API tokens
API tokens require Pro API access. Create one token per integration, grant only the scopes it needs, and copy the token immediately because it is only shown once.
| Scope | Grants |
|---|---|
tickets:read / tickets:write |
Read or manage tickets |
categories:read / categories:write |
Read or manage categories |
panels:read / panels:write |
Read or manage panels |
flows:read / flows:write |
Read or manage flows |
knowledgebase:read / knowledgebase:write |
Read or manage knowledge base |
transcripts:read |
Read transcripts |
webhooks:read / webhooks:write |
Read or manage webhooks |
analytics:read |
Read analytics |
Token rows show the token prefix, name, scopes, creation time, last-used time when available, and Revoke. There is no copy-prefix or regenerate action.
SMS notifications
Server-wide SMS setup requires Pro and a Twilio account. It only configures delivery for the server; each recipient adds their own phone number in personal notification preferences.
| Field | Notes |
|---|---|
| Enable SMS | Turns SMS delivery on for the server. |
| Account SID | Twilio Account SID. |
| Auth Token | Twilio auth token, stored encrypted. |
| From Number | Twilio phone number in E.164 format, for example +1234567890. |
There is no "To Numbers" field and no test button on this page.
Quick checks
| Problem | Check |
|---|---|
| Settings will not save | Validate phone number format, color hex values, and Twilio credentials. |
| Permission denied | Editing settings requires the manageSettings dashboard permission, usually from the Admin role. |
| Bot nickname did not update | Check the bot's Change Nickname permission and server role order, then allow a few minutes. |
| SMS is not sending | Confirm SMS is enabled on Integrations, Twilio credentials are valid, and recipients have opted in with a phone number. |