The helpdesk migration checklist: everything to verify before you switch
A stage-by-stage checklist for switching helpdesks: exit terms, data inventory, field mapping, technical seams, team readiness and post-launch checks.
Key takeaways
- Verify by stage, not by date: fit, exit terms, inventory, field mapping, technical seams, people, cutover rehearsal and post-launch checks apply to any timeline.
- The cheapest failures to prevent are contractual: confirm bulk export rights on your current plan and the auto-renewal notice window before anything else.
- A field-by-field mapping table plus a 50–100 ticket sample import catches the errors that corrupt reporting — type mismatches, status drift and timezone shifts.
- Technical seams cause the visible outages: DNS TTL lowered in advance, webhooks repointed, sign-in confirmed for every agent before cutover day.
- The migration is finished when the numbers are trustworthy — first SLA report checked against baseline, search verified, old tool read-only until billing ends.
Most helpdesk migrations don't fail during the import. They fail three weeks earlier, when nobody checked whether the old plan allows bulk export, or three weeks later, when the SLA report quietly shifted by two hours and nobody could say why. The import itself is mechanical. The verification around it is where projects are won or lost.
This is the master checklist for that verification, organised by stage rather than by date. Whether your cutover is a single weekend or a month of parallel running, the boxes are the same — only the calendar changes. Work through it top to bottom and the move becomes boringly predictable, which is exactly what you want from a project that touches every customer conversation you have.
Stage 1: verify the destination before you commit
The cheapest place to catch a problem is before the contract. Confirm, with evidence rather than sales assurances:
- Every channel you run today has a home. Email addresses, website chat, messengers, social DMs. A channel without a landing spot becomes an emergency two days before cutover.
- The integrations that earn money exist. Billing lookups, order status, CRM sync. Nice-to-have integrations can wait; revenue-touching ones cannot.
- Import support covers your objects. Tickets, contacts, knowledge base articles, macros, tags, custom fields — ask for the list in writing, and ask what happens to attachments.
- The pricing model matches your team's shape. Per-seat pricing punishes growth; flat plans punish very small teams. Model your headcount 12 months out, not today's.
If you're weighing specific vendors, a structured side-by-side like our Freshdesk comparison is faster than twenty tabs of feature pages.
Stage 2: verify your exit path
Your current helpdesk decides how easy it is to leave, and you want those answers while you're still a paying customer in good standing:
- Can your current plan export conversations, contacts, articles and macros in bulk — or is export gated behind a higher tier?
- What formats do exports arrive in, and do they include attachments and inline images?
- When does your contract renew, and how many days of notice does cancellation require? Auto-renewal windows have trapped more teams than any technical issue.
- What does the vendor's policy say about data deletion after departure? You may want a grace period to re-export something you missed.
Stage 3: inventory what you actually own
You cannot verify a migration against an inventory you never took. One person, one document, half a day:
- Every email address that forwards into support — including the aliases someone created years ago and forgot.
- Every widget install and its pages, every connected messenger.
- The macro census: how many exist, which ten are actually used.
- Automation rules — written down in plain language, because rules rarely export cleanly and undocumented ones die silently.
- Custom fields on tickets and contacts, with their types.
- Knowledge base structure: categories, article count, drafts versus published.
- API consumers and webhooks — anything that reads from or writes to the old helpdesk programmatically.
Stage 4: verify the import path field by field
This is the stage teams skip, and it is the stage that decides whether your reports mean anything next quarter:
- Build a mapping table: every source field to its destination field, including type. A dropdown that arrives as free text will haunt your reporting for a year.
- Decide how ticket statuses translate — most tools have five to seven states and they never align one-to-one.
- Pick the deduplication key for contacts (almost always email) and decide what wins when two records collide.
- Confirm attachments and inline images are copied to the new tool's storage, not hotlinked to the old one.
- Run a sample import of 50–100 tickets first. Check timestamps against the source — a silent timezone shift moves every SLA metric by hours. Then check threading, authorship and attachment integrity before committing the full run.
Stage 5: verify the technical seams
The seams between systems are where downtime hides:
- Email routing: lower DNS TTL days in advance, and test forwarding end to end with a real message.
- Widget swap: know exactly which commit changes the snippet, and who can deploy it.
- Sign-in: confirm every agent can authenticate before cutover day, not during it.
- Webhooks and API consumers from Stage 3 all point at the new tool — an integration still writing to the old helpdesk after cutover is the classic source of ghost tickets.
- CSAT surveys send from the new tool and land in its reporting.
Stage 6: verify the people side
- Roles and permissions rebuilt, with at least two admins.
- A one-page cheat sheet mapping old habits to new ones: where views went, how to escalate, the new shortcut keys.
- A named champion per team who learns the tool a week early.
- First-week staffing that assumes a modest productivity dip, because there will be one.
Stage 7: verify the cutover itself
- Replay 25 golden tickets — real conversations from the last quarter — through the new setup and read every answer critically.
- Rehearse the rollback: the two or three steps that revert routing, written down, with a named owner.
- Freeze configuration changes on the old tool during the transfer window so exports stay consistent.
- Prepare the customer note, and keep it to two sentences. Customers care about answer quality, not your tooling.
Stage 8: verify after go-live
The migration isn't done at cutover; it's done when the numbers are trustworthy:
- Watch the queue for ghost silence — a channel producing zero tickets is usually misrouted, not quiet.
- Sanity-check the first SLA report against the old tool's baseline.
- Confirm search finds migrated history and articles.
- Keep the old tool read-only until the billing cycle ends, then confirm the cancellation in writing.
The one-page version
Fit before contract. Exit terms in writing. Full inventory. Field-by-field mapping with a sample import. Seams tested end to end. People prepared, not surprised. Cutover rehearsed with a rollback owner. Numbers verified after go-live. Eight stages, no heroics.
Where MoveDesk fits
MoveDesk exists because this checklist used to take a consultant. The white-glove migration is free on every plan: our team runs the export, mapping and import from Zendesk, Intercom or Freshdesk — attachments, articles, macros and history included — while both tools run in parallel for as long as you want to compare. The 14-day trial is long enough to work through every stage above on your real data before you commit to anything.
Print the checklist, book a quiet week, and start at Stage 1. The teams that verify twice migrate once.
Share this article
Frequently asked questions
For teams of roughly 2–15 agents with standard channels, the mechanical move fits in a weekend once the verification stages are done. The checklist work around it — inventory, mapping, exit terms, rehearsal — typically takes one to two calendar weeks of part-time effort. Larger teams stretch the same stages across a longer parallel-running period rather than adding new steps.
Programmatic consumers: webhooks, API scripts and integrations that quietly read from or write to the old helpdesk. They are invisible in the UI, so they miss the inventory, keep operating against the old tool after cutover, and produce ghost tickets or silent data loss. Listing every API consumer during Stage 3 and repointing each one in Stage 5 prevents it.
Almost never. Twelve months of history satisfies the vast majority of real lookups, and 24 months is the cautious ceiling. Older tickets can be archived as a read-only export and imported later if a genuine need appears. Filtering out spam-closed and one-word tickets before import keeps search results clean in the new tool.
Run a sample batch of 50–100 tickets before the full import, then check four things against the source: timestamps (timezone drift silently corrupts SLA reporting), threading and authorship of replies, attachment integrity, and custom field types. After the full run, replay a set of real past conversations and confirm search finds what agents will look for.
During a product launch, a seasonal peak, a pricing change, or the week a major contract renews — anything that raises ticket volume or stakes. The checklist assumes a quiet window where a modest first-week productivity dip is affordable. If no quiet window exists, run the two tools in parallel and shift channels gradually instead of cutting over at once.
Automation rules nobody can explain, custom CSS hacks, saved views from departed agents, and integrations that exist out of habit rather than value. Workflows that only patched the old tool’s limitations would import the limitation. Reports are better rebuilt from the new tool’s defaults after two weeks of live data than copied wholesale.
Keep reading
Apr 18, 2026 · 9 min read
Switch your helpdesk over a weekend: the Friday-to-Monday playbook
A Friday-evening-to-Monday-morning plan for moving your support stack to a new helpdesk while your customers sleep: what to freeze, what to import, what to test — and the checklists that catch the traps most teams hit.
Read moreApr 2, 2026 · 8 min read
Retraining your support team on a new helpdesk in one week
A five-day plan for moving agents to a new helpdesk: guided orientation, rebuilt workflows, shadow shifts, AI drafts and a live day with a safety net.
Read moreFeb 17, 2026 · 8 min read
How to export your data from a legacy helpdesk (tickets, KB, contacts)
How to get tickets, knowledge base articles, contacts and macros out of a legacy helpdesk: formats, APIs, attachments and the traps that surface later.
Read more