Migration Guide

A concrete, honest checklist for moving from another ticket bot to TicketCord, including what cannot be imported

This guide is for servers that already run a ticket bot and want to move to TicketCord without losing their workflow. It tells you up front what transfers (nothing automatically), how to rebuild each part of your old setup using the real dashboard settings pages, and how to run both bots side by side while you switch.

TicketCord has no importer for other bots. It cannot read another bot's tickets, transcripts, statistics, panels, or settings, and there is no file format you can upload. Everything below is a manual rebuild. Plan for an hour for a typical server, longer if you have many panels or canned responses.

What transfers and what does not

You can keepYou have to rebuildYou cannot bring over
Your Discord roles (staff, admin), categories, and channels: TicketCord can use the ones you already haveTicket panels (embeds and buttons), welcome and close messages, canned responses, tags, auto-close timers, business hours, response targets, webhooksHistorical tickets and transcripts from the old bot, its statistics, its user or staff metrics, and any integrations built against its API

Old tickets stay wherever the old bot stored them. Export them from the old bot before you remove it, or keep the old bot's transcript channel in Discord.

Before you start

  • You need to be the TicketCord account owner to set up the server in the dashboard, configure staff roles, and grant dashboard access. Running /setup in Discord needs Administrator, or Manage Channels plus Manage Roles.
  • Open the old bot's settings and write down: which roles are staff, which categories tickets go to, every panel and its buttons, every welcome or close message, every snippet or canned reply, auto-close timing, and any Slack, webhook, or logging integrations.
  • Decide whether you will reuse the old categories and roles or let TicketCord create fresh ones. Reusing keeps channel permissions and role mentions intact; fresh ones avoid mixing old and new tickets.
  • Every new TicketCord account has a 14-day Enterprise trial, so you can rebuild with every feature available and choose a plan once you know what you use. See Free Trial.

The migration checklist

Create and invite your TicketCord bot

Follow Installation: create a Discord application, paste the bot token into the dashboard (the guided setup on your first sign-in, or Add a bot under Your bots), and invite the bot from the dashboard so it gets every permission it needs. The old bot can stay in the server for now.

Run /setup, or point TicketCord at existing resources

To reuse your old categories and staff roles, pick them in the setup form in the next step.

For fresh ones, click Create them for me in that form: it creates whatever you have not picked (🎫 Tickets, 📁 Closed Tickets, and 📝 Ticket Logs with #ticket-transcripts and #ticket-logs, plus the Ticket Admin and Ticket Support roles) and picks them.

In Discord, /setup does the same; if it finds existing ticket categories or roles it offers Create Anyway (New Names) (a separate 🎫 TicketCord Tickets, 📁 TicketCord Closed, and 📝 TicketCord Logs set), Use Existing (Recommended), or Cancel.

Rebuild the structure and staff

Go to your server (click the server's tile on the dashboard home). A server that was never set up shows its setup form first: pick the staff roles, categories, transcript channel, and logs channel there and click Finish setup. Afterwards the same choices live on the settings pages in the sidebar:

Recreate panels and messages

  • Panels → Ticket panels: build one panel per old panel (New panel). Add a button per old ticket type, or a dropdown if the old panel used a select menu. If the old bot collected answers in a form before opening the ticket, attach a form to the button; multi-step application forms need Basic or higher. Post each panel to its channel from the dashboard or with /embed <name> [channel].
  • Messages: recreate the message users see when a ticket opens. Welcome messages are reusable designs: set one as the default for each ticket type, and pick a different design on any button, dropdown option, form, or application that needs its own text. See Welcome Messages.
  • Staff → Quick replies: add each of the old bot's snippets or canned replies with the same shortcut so staff keep their muscle memory. Staff send them with /reply <shortcut>. Basic and Pro allow 25, Enterprise unlimited.

Plan limits for saved panels: Free 2, Basic and Pro 5, Enterprise 15. If you are consolidating several old panels, count them first.

Recreate the ticket lifecycle

  • Opening tickets → Ticket options: a role while a ticket is open, thread tickets and their archiving, and the per-user open-ticket limit under Ticket limits (1 to 5 on Free, any limit on Basic and higher).
  • Staff → Claiming: whether a claim removes the rest of the team (Exclusive claims) and which supervisor roles keep access.
  • Opening tickets → New ticket defaults: how new ticket channels are named and who is pinged when a ticket opens, if the old bot named or pinged a certain way.
  • Closing tickets → Closing rules: the close confirmation, whether the member gets a DM when their ticket closes (Message the member), and whether the channel is moved (Move closed tickets to) or deleted (After closing). The text of the close notice and the close DM is a design you pick on Messages: switch Automatic messages to Ticket closes (Basic and higher).
  • Closing tickets → Auto-close and reminders: the inactivity timer (/auto-close 2H, 1D, and so on; minimum 15 minutes, maximum 30 days) (Basic and higher) and the reminders sent before closing (Basic and higher).
  • Closing tickets → Ratings: rating prompt after close, if the old bot had one; turn on RestoreCord reviews in the same card if you use RestoreCord.
  • Staff → Tags: recreate any categories or labels staff used to sort tickets; staff apply them with /tag.
  • Closing tickets → Transcripts: whether a transcript is posted on every close. How long closed tickets are kept is Keep closed tickets for under General → Privacy and data. If the old bot kept transcripts forever, note that TicketCord's default is 90 days on Free and 365 days on paid plans; choose Until you delete them on a paid plan if you need indefinite retention.

Set up ModMail if you are replacing a DM-based bot

Go to Opening tickets → How members open tickets, set Members open tickets with to A DM to the bot (ModMail), and save. Then:

ModMail reminders for whoever needs to reply next need Basic or higher. DM to new members on Messages (Basic and higher) replaces bots that greeted new members by DM.

Recreate AI, service levels, and integrations

Test with the old bot still present

Post the new panel in a private channel first. Open a ticket with each button, claim it, add a user, send a quick reply, close it, and confirm the transcript lands in the transcript channel and the ticket appears in Tickets. Run /diagnose to catch permission gaps. If the old bot also responds to ticket buttons in the same channel, keep the new panel in a separate channel until the switch.

Switch over

  1. Announce the change and the date.
  2. Post the TicketCord panels in the real support channels and delete or disable the old bot's panels.
  3. Let open tickets on the old bot finish naturally, or ask staff to close them and reopen anything unresolved in TicketCord.
  4. Remove the old bot from the server, or at least strip its ability to create channels, so members cannot open tickets in two systems. If both bots register similar slash commands, removing the old bot is the only reliable way to avoid confusion.
  5. Keep the old bot's transcript channel or exported files for as long as you need the history.

Where each old setting goes

Old bot settingTicketCord page → blockNotes
Support team / staff rolesStaff → Staff rolesReuse existing Discord roles
Ticket categoryOpening tickets → Ticket categoriesReuse existing categories or use the ones from /setup
Closed categoryClosing tickets → Closing rulesMove closed tickets to; hidden while After closing is Delete the channel
Log channelGeneral → Where the bot postsStaff logs; the other channels default to it
Blacklist / allowlistOpening tickets → Who can open ticketsMembers and roles
Panels, reaction or button menusPanels → Ticket panelsOne panel per old panel; buttons, dropdowns, modals, application forms
Ticket welcome messageMessagesDesigns reusable across buttons
Snippets / canned replies / macrosStaff → Quick repliesSame shortcuts, /reply
Per-user open-ticket limit, thread archivingOpening tickets → Ticket optionsFree allows 1 to 5 open tickets per user; any limit from Basic
Claim settingsStaff → Claiming
Close confirmation, close DMClosing tickets → Closing rulesMessage the member sends the close DM. The close notice and close DM text are designs picked on Messages (Basic and higher)
Inactivity auto-close and remindersClosing tickets → Auto-close and remindersBasic and higher
Rating / feedback promptClosing tickets → Ratings
Ticket categories or labelsStaff → Tags
Transcript channel, retentionGeneral → Where the bot posts, General → Privacy and dataTranscripts and Keep closed tickets for
DM-based tickets, anti-spam rulesOpening tickets → How members open tickets, Opening tickets → Who can open ticketsModMail's own options are on ModMail → ModMail
Slack / webhook integrationsGeneral → WebhooksEnterprise
Bot languageGeneral → Bot language19 languages

Migrating from a specific bot

The mapping is the same for every source bot; the differences are in what you have to look up in the old bot.

From a panel-based ticket bot (Ticket Tool, Tickets, Discord Tickets, and similar)

Take a screenshot of every panel and note each button's ticket type, the category it opens in, the support roles it pings, and any form questions.

Rebuild them under Panels → Ticket panels, and their welcome messages under Messages. Reuse the old support roles under Staff → Staff roles. Recreate auto-close under Closing tickets → Auto-close and reminders and transcripts under Closing tickets → Transcripts.

Old transcripts stay with the old bot; download them before removing it if it offers an export.

From a ModMail bot

Turn ModMail on under Opening tickets → How members open tickets. Its category is under Ticket categories, account-age and membership requirements under Who can open tickets, and anonymous replies and a reopen cooldown on the ModMail page. Recreate snippets under Staff → Quick replies. Old ModMail threads and logs are not imported; keep the old log channel or export it. Once enabled, tell members to DM the new bot instead of the old one and remove the old bot so DMs are not handled twice.

From a bot with a web dashboard or API

Any web configuration must be rebuilt by hand on the settings pages above. Anything that consumed the old bot's API or webhooks needs to be rewritten against TicketCord's outgoing webhooks (Enterprise). There is no compatibility layer.

Running two bots at once

  • Use separate channels for the old and new panels and label them clearly.
  • Keep the old bot's ability to create tickets only as long as you need it to finish open tickets.
  • Staff can use both systems in parallel because TicketCord only manages the channels it created.
  • Remove the old bot once its last ticket is closed; two bots registering similar slash commands is the most common source of confusion during a switch.

Troubleshooting a migration

SymptomCauseFix
Members see two ticket buttonsBoth panels are liveRemove the old panel or its bot
Old bot's commands still appearIts application commands stay registered while it is in the serverRemove the old bot from the server
TicketCord cannot create tickets in the old categoryBot lacks Manage Channels or Manage Roles there, or the category has 50 channels (TC002 or TC019)Grant the permissions in the category, or move old channels out. Run /diagnose
Staff cannot see new ticketsTheir role is not listed under Staff → Staff rolesAdd the role, or give staff the roles from /setup
Transcripts missingNo transcripts or logs channel selected, or the Transcripts switch is offChoose a channel under General → Where the bot posts and turn on Closing tickets → Transcripts
A feature from the old bot seems missingIt may have a different nameCheck the FAQ and the feature pages; if it is genuinely missing, suggest it in the support Discord

Common questions

Can TicketCord import my old tickets or transcripts?

No. There is no importer and no upload format. Export from the old bot before removing it and keep the files or its transcript channel.

Do I have to make new staff roles?

No. Pick the roles you already use in the setup form on your server, or later under Staff → Staff roles. If you prefer fresh ones, Create them for me in the setup form (or /setup in Discord) creates Ticket Admin and Ticket Support roles.

Can I keep my old categories and channels?

Yes. Pick them in the setup form, or later under Opening tickets → Ticket categories. (If you run /setup, choose Use Existing (Recommended) when it detects them.) Make sure the bot has Manage Channels and Manage Roles in those categories.

Can I test TicketCord without removing the old bot?

Yes. Post the new panel in a private channel, run through a full ticket, and only switch the public channels when you are happy. Remove the old bot at the end to avoid duplicate buttons and commands.

Which plan do I need for the migration?

Every new account has a 14-day Enterprise trial, so rebuild with everything available and then compare what you used against Plans & Pricing. Auto-close, quick replies, application forms, and DM on join need Basic; AI needs Pro; webhooks, response targets, business hours, and approvals need Enterprise.

Last updated on

On this page