Skip to content
MegAligna

Migration guide

How to switch from TherapyNotes — exports, mapping, cutover

Moving off TherapyNotes is an export, a mapping and one parallel month. This guide covers what TherapyNotes lets a practice export, how clients, appointments and notes arrive in MegAligna, what does not transfer — submitted claims and remittance history stay behind — and the cutover order that keeps documentation and billing continuous.

Start free trial See pricing

Why leaving TherapyNotes is two migrations

Leaving TherapyNotes usually means two changes at once: new practice software, and billing moving from the in-app pipeline to your own biller.

Plan them as separate workstreams sharing one cutover date. The biller needs payer lists, fee schedules and enrollment status well before the Monday you switch, and that half of the move takes longer than the software migration.

Notes and treatment plans are the ones to check first

A TherapyNotes migration turns on documentation, because documentation is what the practice has most of and what it is most nervous about losing.

Treatment plans are the sharper half of that. A plan is a live clinical document with goals that are being worked toward right now, which makes it different from a historical note in one important way: a note only needs to be readable, and a plan needs to be actionable. Plans arriving as attached documents means someone re-enters the active ones as structured goals on the other side.

That is manageable, and it is manageable specifically because it applies to active clients rather than to your whole history. Count them before you plan the migration — practices consistently overestimate the number and then discover the job was two days rather than two weeks.

The mechanics of the import itself — the record types, the dry run, what arrives as documents — are the same for every source system and are covered in migrating practice management software.

What maps, and what does not

Maps as structured data: client demographics, guarantor and payer details, and appointment history with recurring patterns.

Arrives as documents: progress notes, treatment plans, intake documents and uploads, attached per client. The clinical record is preserved as documents rather than converted into structured fields.

Stays behind: claims submitted through TherapyNotes and their remittance history, payer enrollments tied to their pipeline, and portal message threads. Post the last remittances before the account closes, and export financial reports as files for your records.

Cutover order

Reconcile client balances from your final TherapyNotes statement run, then import. From the agreed Monday: sessions document here, charges export to your biller from here, and the TherapyNotes account stays alive read-only until its last claim adjudicates. One date, no split weeks.

The TherapyNotes comparison covers the group-size pricing question that usually prompts this. On the documentation side, note templates show what arrives structured and what does not, which is the part of a migration people underestimate.

Common questions

Our payer enrollments were set up through TherapyNotes — do we lose them?
Enrollment belongs to the practice and its NPIs, but the routing configured for their pipeline does not follow you. Your biller re-establishes submission under their own setup — start that paperwork weeks before cutover, not after.
How do we price the overlap month?
One month of both subscriptions plus your biller's setup, all computable in advance because our pricing is published. The overlap is not waste; it is what keeps the last TherapyNotes claims collectable.
Do treatment plans need to be rebuilt?
Historical plans import as documents. Active clients get their current plan re-entered as structured goals here — an hour per caseload-heavy clinician, and worth it, because goal-linked notes are the point of the system you are moving to.

Try it end to end with test data

14 days, no card required. Use made-up patients while you evaluate — real patient information waits until a business associate agreement is in place.