Operations · 8 min read

The Freelance Tool Migration Playbook

How to switch from one client-management tool to another without breaking active engagements. Two-week overlap, what to migrate, what to leave behind.

Published May 10, 2026

The single biggest reason freelancers stay on a tool they have outgrown isn't loyalty or familiarity — it's migration fatigue. By month three of a new tool, half their data lives there and half is still in the old place. By month six, they're back on the old tool out of frustration and the new subscription is wasted spend.

This isn't a tool problem. It's a migration-execution problem. Below is the playbook that actually works, refined across watching dozens of freelancers switch between HoneyBook, Dubsado, Bonsai, 17hats, and emerging alternatives.

The principle: don't switch your active projects

The most expensive mistake in tool migration is moving in-flight client engagements to the new tool mid-project. The client notices: their portal URL changes, their invoice numbering changes, the look of the email they get changes. They send a confused message. You lose 30 minutes explaining. Trust takes a small hit.

Don't do that. Finish active projects in the old tool. Start new projects in the new tool. Run two weeks of overlap. Cancel the old tool after the last in-flight project clears.

The two-week timeline

Day 1: Export everything from the old tool

Every tool worth migrating from supports CSV export of clients, projects, invoices, and time entries. Run all of those exports on day 1. Don't wait — if your subscription lapses, some tools restrict access to historical exports.

Pull copies of your templates too: proposal templates, contract templates, invoice templates. Most tools let you copy the source text from the editor; some require you to render to PDF first. Either way, get them out.

Day 1-2: Set up the new tool

Sign up. Connect your Stripe (or whatever your payment processor is). Upload your logo. Pick your brand color. Don't import historical data yet — you don't need it.

Recreate the 2-3 templates you actually use weekly. Don't try to recreate everything. Most freelancers have 20+ accumulated templates in their old tool; they use 3 of them. The other 17 are dead weight. Don't bring dead weight forward into your new setup.

Day 3: Start sending new proposals in the new tool

First new proposal goes through the new tool. Don't pick your most valuable lead for this — pick one where the relationship is solid and the stakes are moderate. You're testing the workflow, not optimizing the close.

When the proposal converts, the engagement runs entirely in the new tool. Contract, invoicing, time tracking, payment — all new.

Day 4-10: New work flows through the new tool only

Every new lead, every new proposal, every new project — new tool only. The old tool is read-only for you during this window: you finish active engagements there, but you start nothing new.

This is the hardest part because the new tool feels less comfortable. Resist the urge to fall back. Send the proposal through the new tool even if it's 10% slower the first time. By day 7 it'll be faster.

Day 11-14: Wind down the old tool

Active engagements in the old tool are now at their natural completion point — final deliverable shipped, final invoice sent. Wait for the last invoice to clear before cancelling the subscription. Some tools have export restrictions on cancelled accounts, so don't cut access to your data prematurely.

Cancel the old subscription with whatever notice the provider requires. Pull a final CSV export to keep archival access to historical data. Save it somewhere you can find again in 3-5 years if a client comes back asking for an old invoice copy.

What to migrate, what to leave

Migrate:

  • Active clients. Names, primary contact, email, phone, custom notes. CSV import; most new tools handle this in a single upload.
  • The 2-3 templates you actually use weekly. Recreate the text in the new editor; don't try to import formatting fidelity.
  • Your brand assets. Logo (high-res PNG), brand color (hex), domain for the client portal subdomain.
  • Your standard contract. The signed version of your master template, ideally reviewed by a contract lawyer once. Don't use the new tool's default — your old contract is battle-tested.

Don't migrate:

  • Historical invoices. Already sent, already paid. Keep them in a CSV archive, don't import them.
  • Dormant clients. Anyone you haven't billed in 12+ months. They're in your email history if you need them; don't pollute the new CRM.
  • Templates you used once. The temptation is “I might need this someday.” You won't.
  • Workflow automations. Set these up fresh in the new tool based on what you actually do today, not what you set up two years ago and forgot about.
  • Inactive integrations. Don't reconnect the Zapier flows that broke months ago. Reconnect what you actually use.

The client-communication question

You don't need to tell clients you switched tools. The professional version of this is silent: the proposal looks polished, the contract is clean, the invoice is paid through their normal Stripe checkout, and the client's only observation is “huh, that was easy.”

If a client asks (rare), the truthful answer is short: “We moved our back office to a new tool. You shouldn't notice any difference; let me know if you do.” That's it. No apology, no explanation, no implicit weakness.

The exception: when to break the playbook

Two cases where you might switch mid-project:

Tool failure. If your current tool is actively broken — payments failing, portal links 404ing, support unreachable — you migrate immediately, even mid-project, with a client-facing apology and explanation. The cost of staying on the broken tool is higher than the cost of the switch.

Forced sunset. If your provider announces they're shutting down (rare, but it happens), you migrate before the sunset date with the same client-facing communication. Better to switch on your schedule than have access cut.

For everything else — better pricing, better features, better UX — finish in the old tool and start in the new one. Two weeks of overlap, then done.

The migration-fatigue prevention principle

The best defense against future migration fatigue is to make the next migration easier from day one of your current tool. Three habits:

  • Export monthly. Set a calendar reminder to pull CSV exports of clients, invoices, and time entries from your active tool every month. Drop them in a dated folder in your Drive. If you ever need to migrate, you have a recent archive without depending on the provider.
  • Use your own Stripe. Tools that route payments through their own processor (HoneyBook, Bonsai Payments, Dubsado Payments) make migration harder because your payment history lives with them. Tools that use Stripe Connect (where you connect your own Stripe account) leave payment history portable. See our comparison pages — HoneyBook, Dubsado, Bonsai — for which model each uses.
  • Keep templates in plain text. Maintain a copy of your proposal and contract templates as Markdown or plain text in a Notion / Obsidian / Google Doc, separate from any single tool. Tool-specific formatting comes second.

Migration fatigue is a real cost; tool stickiness is real. But with a 2-week overlap and the discipline to only bring forward what you actually use, switching is genuinely tractable.

Try Scopivo free

Built for solo freelancers and small studios. Proposals, contracts, invoices, and time tracking in one place. Free for your first year.

Related