Configuration

TicketFlow has two levels of configuration: server-wide settings and per-board settings.


Server Settings

These apply to all boards on your server. Set them with /config commands or from the web dashboard under Settings.

Setting
Command
Range
Default
Description

Log Channel

/config logchannel

Any text channel

None

Channel where ticket events (open, claim, close) are logged

Max Tickets / User

/config maxtickets

0–25

0 (unlimited)

Maximum open tickets a user can have across all boards

Auto-Close Days

/config autoclose

0–90

0 (disabled)

Close tickets after this many days of inactivity*

Auto-close runs periodically. Tickets with no activity for the configured number of days are closed automatically with a transcript DM to the creator. Empty tickets (no messages) are also cleaned up after the configured period.


Board Settings

These are set when creating a board with /setup and apply only to that specific board.

Setting

/setup Option

Range

Default

Description

Name

name

Max 100 chars

Required

Display name shown on the embed

Category

category

Channel category

Required

Where ticket channels are created

Staff Role

staff_role

Any role

Required

Role that can see and manage tickets

Description

message

Max 2000 chars

Generic message

Text shown on the board embed

Embed Color

color

Hex code

#5865F2

Accent color of the board embed

Max Tickets / Board

maxtickets

0–25

1

Max open tickets per user on this board


How Ticket Limits Work

TicketFlow checks two limits when a user tries to open a ticket:

  1. Board limit — How many open tickets the user has on that specific board (set in /setup)

  2. Server limit — How many open tickets the user has across all boards (set in /config maxtickets)

Both must pass for the ticket to be created. A value of 0 means unlimited.

Example: If the server limit is 5 and the board limit is 2, a user can have at most 2 open tickets on any single board, but up to 5 total across all boards.


Plan Limits

TicketFlow has three plan tiers that control how many boards and templates you can create:

Plan
Templates
Boards
Fields per Template

Free

3

3

5

Pro

25

10

5

Enterprise

100

50

5

All plans support the same field limit per template (5 fields — the Discord modal maximum). If you exceed a plan limit, the action is blocked and you'll see a message with the current cap.


Permissions

TicketFlow uses Discord's built-in permission system:

Action
Who Can Do It

Run /setup, /config commands

Users with Manage Server permission

Claim a ticket

Staff (users with the board's staff role)

Close a ticket

Staff OR the user who opened the ticket

Access the web dashboard

Users with Manage Server permission on the server

Reply from the dashboard

Users with Manage Server permission


Logging

When a log channel is configured, TicketFlow posts an embed for each ticket event:

  • Ticket Opened — Who opened it, which board, channel link

  • Ticket Claimed — Who claimed it, ticket details

  • Ticket Closed — Who closed it, duration, message count

Logs help you track support volume and staff response times. Set a log channel with:

Last updated