Guide
Switching EHRs: What Behavioral Health Practices Need to Know Before They Sign
A cutover plan for moving records, billing operations, staff workflows and patient facing processes when you change EHRs, including what to verify before you sign.
Behavioral Health EHR Migration Guide
A practical cutover plan for moving records, billing operations, staff workflows, and patient-facing processes without treating the change like a simple software login.
Short Answer
A safe EHR switch starts with a field-level conversion manifest. The go-live date comes later. First decide exactly what has to move, what stays available in the old system, what gets rebuilt, how each item will be tested, and who has the authority to stop the cutover. Billing runs as its own workstream. And before the final conversion, you run a test conversion, reconcile the results, and write down a rollback or downtime plan you’d actually be able to use.
This guide starts after a practice has decided replacement is likely. If you’re still working out whether the problem is the EHR itself or the way it’s configured and used, start with EHR optimization vs. replacement.
An EHR Switch Is Four Connected Projects
The incoming vendor will usually hand you a polished implementation schedule. It may cover account configuration, training and the vendor’s own import. It may not touch your open claims, clearinghouse relationships, payer-specific enrollments, unposted remittances, unscheduled referrals, the portal transition, custom reports, or the exceptions that don’t fit the import template.
1. Data Conversion
Export, map, transform, import, and validate the records and operational data the practice must retain or use.
2. Workflow Rebuild
Recreate forms, templates, queues, permissions, reports, routing rules, reminders, and staff responsibilities.
3. Revenue Cutover
Control where charges are entered, claims are submitted, acknowledgments are worked, ERAs are posted, and old A/R is followed.
4. Operational Stabilization
Support staff, triage defects, reconcile daily totals, and close gaps after the new system becomes the system of work.
Practice size changes how much coordination you need. It doesn’t change the standard. A solo clinician and a multisite group both need a written definition of what “successfully moved” means before anything moves.
Build The Conversion Manifest Before You Set The Cutover Date
A conversion manifest names each information category along with its source, destination format, responsible person and acceptance test. “Move all patient data” isn’t a manifest. Where the risk justifies it, go all the way down to the field and the document type.
| Workstream | Items to inventory | Destination decision | Acceptance evidence |
|---|---|---|---|
| Practice and provider setup | Locations, Tax IDs, NPIs, taxonomy, licenses, service facilities, rendering/billing rules, fee schedules, supervision relationships | Rebuild as structured configuration; do not rely on screenshots alone | Approved provider/location matrix and test claims for each material billing combination |
| Patient identity and contacts | Name, identifiers, demographics, contacts, guardians, communication preferences, alerts, duplicate records | Structured import, manual exception queue, or archived reference | Record counts, required-field checks, duplicate report, and sample chart comparison |
| Coverage and authorizations | Payer, plan/network, member and group data, order of benefits, effective dates, authorization number, units, dates, servicing constraints | Discrete fields where the new system supports them; secured document/reference where it does not | Active-population reconciliation and validation of time-sensitive authorizations |
| Clinical record | Diagnoses, treatment plans, signed notes, assessments, orders, medication history, consents, releases, uploaded documents | Structured clinical data, document images/PDFs, or read-only legacy access by category | Clinical lead review of representative and high-risk charts, dates, authorship, signatures, and document legibility |
| Psychotherapy notes and specially restricted data | Separately maintained psychotherapy notes, substance-use-disorder records, restricted charts, minors, sensitive documents | Separate policy-driven handling; never assume the general export or import covers these correctly | Privacy/legal review, permission testing, and documented authorized access |
| Scheduling and access | Future appointments, recurring series, waitlist, resources, rooms, telehealth links, portal accounts, reminders | Import where supported; otherwise rebuild from an approved future schedule report | Day-by-day calendar comparison, recurrence testing, and reminder/portal test |
| Referrals, tasks, and messages | Open referrals, unsigned work, incomplete intake, tasks, inboxes, portal messages, fax queues, document requests | Convert only if supported and testable; otherwise create a controlled open-item worklist | Named owner, next action, due date, aging, and closure criteria for every open item |
| Charges, claims, and A/R | Unbilled encounters, held claims, accepted/rejected claims, denials, appeals, secondary claims, timely-filing dates, patient balances | Define the system that owns each date-of-service range and each open balance | Financial control totals by payer, aging bucket, provider, location, and responsibility |
| Payments and remittance | ERAs, EOBs, EFT references, posted/unposted payments, adjustments, refunds, credits, unapplied cash, payment plans | Structured ledger only when reliable; otherwise preserve a supported legacy ledger plus documented worklist | Bank-to-ERA-to-ledger reconciliation and review of credits/unapplied balances |
| Templates, rules, and reporting | Forms, note templates, intake packets, routing, alerts, automations, dashboards, custom reports, exports | Rebuild intentionally; remove obsolete configuration rather than copying it blindly | Scenario tests and owner approval for every business-critical workflow and report |
| Audit and provenance | Created/modified dates, author, signer, amendments, access history, status history, original identifiers | Retain what policy, contract, law, and operational need require; document what cannot be imported | Traceability sample from destination back to source and secure retention plan |
On every row, record whether the result will be discrete usable data, a viewable document, a searchable archive or only temporary legacy access. Each row also gets source, destination and exception counts, an owner, a due date and a sign-off.
Synthetic example
What A Real Migration Tracker Looks Like
A useful tracker isn’t a blank spreadsheet with “data migration” on one line. Here’s what one row looks like: the item is future recurring appointments, from source report Schedule Detail v2, with 1,842 source rows, import method vendor template, a test sample of 45 appointments across five clinicians, owner Operations Lead, 17 exceptions, next action correct recurrence rules, a due date, and a visible Needs retest status. A second view rolls open issues up by owner, severity and days to go-live.
Read The Old And New Contracts As Operational Documents
Before you cancel anything, read the subscription agreement, the business associate agreement, the order form, the data-export and interface terms, the services scope and the renewal notice. Treat this as operational guidance. It isn’t legal advice, and legal conclusions belong with qualified counsel.
Ask both vendors to answer these questions in writing:
- Who may request a full-practice export, and how is identity and authority verified?
- Which record types, fields, identifiers, attachments, logs, and financial details are included, and which are excluded?
- Which outputs are structured and computable, which are PDFs or images, and how is the format documented?
- Are future appointments, recurring rules, open tasks, portal messages, authorizations, claims, ERAs, adjustments, and audit history included?
- How long does an export request take, how long is the download available, and can a corrected export be produced?
- What are the export, conversion, interface, consulting, storage, and read-only-access fees?
- What is the cancellation notice, renewal date, minimum term, and post-termination access?
- What secure transfer method and file-size limits apply?
- Who owns field mapping, exception cleanup, reconciliation, and failed-record correction?
- Which historical records can the destination import as discrete data, and which become attached documents?
- What support is available during test conversion and go-live, including for interfaces and connected services?
- When and how will remaining copies be returned, retained, or destroyed under the governing agreements and applicable requirements?
HHS explains that a business associate generally can’t block a covered entity’s access to PHI it maintains on the entity’s behalf, and that the business associate agreement governs how PHI is returned at termination. HHS is also clear that the covered entity is still responsible for making sure its own PHI is available. In other words, the practice can’t hand that responsibility to the vendor. Read the HHS guidance on business-associate access and return of PHI and the HHS sample BAA provisions.
For certified health IT, ASTP/ONC’s EHI export criterion describes single-patient and patient-population export in electronic, computable formats, with the format documented. You still have to verify that your particular product, module, information category and workflow are actually covered. The official EHI export criterion is the place to start.
API And FHIR Access Can Help But Neither Means “everything Migrates”
FHIR is an HL7 standard for exchanging healthcare information electronically. It gives you reusable resources and implementation rules. What it doesn’t give you is a promise that every operational, clinical, scheduling or financial object in a specific EHR is exposed, writable, or accepted by the other EHR. Start with the HL7 FHIR overview.
Before you commit to an API-based conversion, get both systems’ capability statements, implementation guides, scopes, resource lists, limits, identifier rules and production-registration process. Then pin down the access itself. Is it patient-level or organization-level, read-only or write-enabled, sandbox or production? And are history, provenance and documents available at all?
Don’t assume a certified API has to be free. ASTP/ONC requires vendors to publish technical and business terms, fee information included, and its rules prohibit some fees while permitting others in defined circumstances. Read the vendor’s terms alongside the official API Condition and Maintenance of Certification guidance.
Vendor Export Behavior Is Not Interchangeable
The vendors’ own documentation shows why the manifest has to be specific. SimplePractice describes several clinical, administrative and billing export categories, then separately points users to an appointment-status report, because appointments aren’t in that data export. TherapyNotes describes importing demographic and insurance data through that process. Clinical documentation, treatment plans, billing history and the existing calendar don’t come through it. Sessions Health splits categories into ones that usually transfer and ones that rarely do, and says results depend on the prior EHR’s export.
These are examples. They aren’t endorsements, and they aren’t permanent comparisons. Confirm the live documentation and get a written vendor commitment for the exact products and services you’re buying.
Treat Revenue Cycle Cutover As A Separate Controlled Launch
A go-live can succeed clinically and still leave you with a cash-flow problem if nobody’s clear on who owns claim submission, acknowledgments, remittance, posting and follow-up. Build an RCM cutover matrix by payer, network, provider, location, billing organization/Tax ID, clearinghouse, transaction type and effective date.
- One ownership rule. Decide which system owns charges and claims, by date of service, entry date, payer or some other rule nobody can misread. Then publish examples for the hard cases: late notes, corrected claims, secondary claims and retroactive eligibility.
- Every connection, inventoried. That covers eligibility, claim submission, claim acknowledgments, claim status, attachments, ERA delivery, EFT destination, statements, card processing, prior authorization, and any payer portal or direct connection you rely on.
- Enrollment and routing for every transaction. Having a software account doesn’t prove each provider/payer transaction is active. For each one, record the submission date, confirmation, payer or trading-partner status, test result and production-ready date.
- Protect old A/R. Keep a worklist for accepted claims, rejections, denials, appeals, underpayments, unapplied cash, refunds, credits, secondary balances and timely-filing deadlines, and name the system of record and the owner for each category.
- Reconcile daily. Compare encounters to charges, charges to claim files, claim files to acknowledgments, payments to ERAs/EOBs, and deposits to posted payments. Month-end is too late to find out a queue went missing.
Medicare’s official EDI guidance shows why this has to be explicit. Provider, clearinghouse and billing-service relationships run through EDI enrollment and trading-partner processes, and changing a billing agent or clearinghouse can require notice or updated arrangements. It’s in the Medicare Claims Processing Manual, Chapter 24. Commercial and Medicaid processes vary, so check each payer’s current rules rather than applying Medicare’s steps everywhere.
Run A Test Conversion That Can Fail Safely
A test conversion isn’t done until practice owners can prove the priority data is accurate, usable, correctly permissioned and working in realistic workflows.
Build Test Cohorts Intentionally
Put the hard cases in on purpose: active and inactive patients, several coverage and claim states, different locations and roles, guardians and minors, duplicate or restricted charts, recurring appointments, amended documents, active authorizations, credits, unusual characters, and records near known limits.
Test Each Workflow From Start To Finish
- Patient registration or lookup, without creating a duplicate.
- Schedule, reschedule, cancel, and complete an appointment.
- Intake, consent, documentation, signature, amendment and release workflows, run all the way through.
- Role-based access, including proof that access doesn’t exist where it shouldn’t.
- Prescriptions, labs, telehealth, fax, portal, reminders and any interfaces in scope.
- Create a charge, submit a test claim where permitted, receive acknowledgments, work a rejection, and verify remittance/posting behavior.
- Operational and financial reports, reconciled to known source totals.
- An export from the new system, so you already know your next exit path.
Use severity levels and stop/go thresholds. A cosmetic label can wait for a post-launch fix. Missing signed notes, incorrect patient matching, broken prescribing, incorrect claim identity, inaccessible time-sensitive information or a material financial imbalance can’t. Any of those should trigger a hold unless an authorized leader accepts a documented safe workaround.
ASTP/ONC’s SAFER Guides emphasize contingency planning and the safe configuration, validation and maintenance of EHR systems and system-to-system APIs. They’re worth reading before you design your testing and downtime controls: SAFER Guides.
Use A Documented Go-Live Plan With A Real Rollback Decision
A go-live plan should say exactly when the old system stops taking each type of new work, when the final extracts run, when interfaces switch over, who verifies each milestone, and how staff record work if a critical function goes down. “Call the vendor” isn’t a rollback plan.
Minimum Cutover Controls
- A minute-by-minute or checkpoint-based cutover schedule with named owners and backups
- Final source freeze rules and an exception log for work created during the transition
- Secure final exports, checksums or file inventories where appropriate, and access logs
- Contact paths for both vendors, clearinghouses, interfaces, payment services, and internal leaders
- Downtime forms and instructions for scheduling, documentation, prescribing, billing, and urgent operational communication
- Go/no-go checkpoints and the person authorized to delay or reverse each part of launch
- A rollback time limit, data-reentry plan, and rule for reconciling work completed in either system
- Daily stabilization huddles, issue severity, response owner, next update time, and closure evidence
Not every migration can be rolled back in one motion. You might pause interfaces, extend read-only access, revert a scheduling workflow, or temporarily submit claims from the old system while clinical documentation stays in the new one. If a split state is possible, define it before go-live, and name the source of truth for every workflow.
Staff Readiness Is Evidence, Not Attendance
Sitting through training doesn’t prove anyone’s ready. Require role-based practice instead: schedulers handle exceptions, clinicians document and amend, billers work acknowledgments, managers reconcile, and administrators manage permissions and downtime. Then write down who passed and who still needs support.
What Practitioners Say And How To Use Anecdotes Responsibly
Reddit threads are anecdotes. They aren’t evidence of how a vendor performs across the board, but they do surface good questions to test. In one r/therapists discussion about changing EHRs with a large caseload, participants described the downloads, imports, cleanup, retraining and billing continuity work involved. In another EHR-transfer discussion, the original poster worried about future schedules and keeping exported records secure.
Use anecdotes to shape demos and contract questions, not to make purchasing claims. Have the vendor show you, with representative test data, your exact future-appointment import, note format, billing-history treatment, portal experience and exception report.
Ungated Resource
Printable EHR Switching Checklist
Print this page or save it as a PDF. You don’t need to give us an email address.
- Executive sponsor, project lead, clinical lead, billing lead, technical lead, and privacy/security owner named
- Old and new contracts, BAAs, order forms, interface terms, and renewal dates reviewed
- Cancellation, export-request, read-only access, retention, and destruction terms confirmed in writing
- Full conversion manifest approved
- Source counts and financial control totals captured
- Structured data, document, archive, and legacy-access decisions recorded by category
- Psychotherapy notes and specially restricted records addressed separately
- API/FHIR scopes, direction, resources, limits, registration, and fees confirmed
- Secure transfer method and vendor file-size limits tested
- Future schedules, recurring appointments, waitlists, tasks, referrals, and messages accounted for
- Payer/provider/location/clearinghouse RCM matrix complete
- Eligibility, claims, acknowledgments, attachments, ERA, EFT, statements, and payment processing verified
- Old A/R, denials, appeals, credits, refunds, and unapplied cash assigned
- Test conversion completed with representative edge cases
- Record counts, exception counts, permissions, signatures, dates, and documents reconciled
- Critical clinical, scheduling, portal, billing, reporting, and interface scenarios passed
- Go/no-go thresholds and authorized decision maker documented
- Source freeze, final extract, delta work, and final validation steps scheduled
- Downtime and rollback procedures tested
- Role-based staff readiness verified
- Patient and referral-source communications approved and scheduled where needed
- Go-live command center, issue tracker, owners, and update cadence ready
- Daily encounter, charge, claim, payment, and deposit reconciliation assigned
- Legacy access and decommission date tied to validation and retention requirements
- Post-go-live review and unresolved-exception ownership scheduled
How AdvanceAPractice Can Help When The Timeline Is Tight Or The Practice Is Large
A compressed timeline or a larger practice turns into a coordination problem well before it’s a software problem. Every added location, clinician, billing combination, interface, form and piece of open work is another place where one missed dependency can hit patients, staff or cash flow. AdvanceAPractice adds experienced operational capacity. The practice keeps ownership of the project.
We can inventory the current environment quickly, turn vendor promises into a field-level conversion manifest, find the high-risk gaps, and put a single owner and an acceptance test on every item. We coordinate the written questions and working sessions with the outgoing EHR, the incoming EHR, the clearinghouse, the billing team and the other vendors involved. What we can’t do is guarantee how fast a third party responds or finishes its work. We make the dependencies, requests, dates, decisions and escalation paths visible, so the practice can act sooner.
On the data side, we can organize test extracts, mapping decisions, test conversions, exception cleanup, and both count-based and sample-based validation. Revenue cycle gets its own track. There we map the claim and remittance pathways, build the payer/provider/location cutover matrix, assign old A/R and define daily reconciliation. For staff readiness, we translate configuration into role-based scenarios, collect test evidence, track open issues, and prepare downtime instructions practical enough to use.
When Command Suite is part of the engagement, the practice sees the project as a working operating system instead of a pile of email threads. Every conversion object, vendor dependency, test result, owner, next action, due date, risk and decision sits in one controlled view. What you get at the end is a documented go-live plan with checkpoints, sign-offs, contingency steps and post-launch ownership. It isn’t a generic recommendation deck.
Our team brings hands-on behavioral health operations, billing, credentialing, workflow and systems experience. Software can organize evidence and watch tasks. People with experience make the mapping decisions, push back on assumptions, coordinate the parties, validate results, and help the practice decide whether it’s safe to go.
Need Help Making The Switch Executable?
If you still need to define the operational problem, start with the EHR workflow and optimization overview. If the replacement decision is made and the date, the scale or the risk calls for hands-on coordination, ask the Practice Concierge for an instant answer.
Frequently Asked Questions
How Long Does It Take To Switch EHRs?
There’s no responsible universal timeline. How long it takes depends on contract and export lead times, practice size, data volume and quality, import limits, interfaces, payer and clearinghouse work, staff availability, testing results and third-party response times. Build the date backward from confirmed dependencies and acceptance criteria. Don’t pick it from a sales estimate.
Does FHIR Mean All Of Our Data Will Move Automatically?
No. FHIR is a standard for exchanging healthcare information, but a particular implementation may expose only certain resources, fields, operations or access scopes. It might not cover every document, task, schedule rule, audit detail, custom field, claim artifact or financial ledger item your practice uses. That’s why you compare the source and destination capabilities against a field-level conversion manifest.
Should We Keep Read-Only Access To The Old EHR?
Often, yes. Read-only access is useful while the practice validates converted information, works old receivables, meets retention obligations and handles exceptions. How long you keep it, and how, depends on the contract, record-retention requirements, cost, security and what actually exported successfully. Confirm those terms before you cancel, and get legal advice where you need it.
How Do We Reduce Cash-Flow Disruption During The Switch?
Run the revenue cycle cutover as its own explicit project. Decide which system owns each charge and date-of-service range, verify payer and clearinghouse routing, protect old A/R, track acknowledgments and remittances, and reconcile encounters, charges, claims, payments and deposits every day. Anything unresolved stays on a worklist with a named owner until it’s closed.
What Should We Test Before EHR Go-Live?
Test representative and high-risk records, plus the complete workflows staff will actually perform: identity matching, scheduling, intake, documentation, signatures, permissions, prescribing and interfaces when in scope, claims, acknowledgments, remittance, posting, reporting, downtime, and export from the new system. Then reconcile counts and financial totals, log the exceptions, and don’t go live without owner sign-off.
When Should A Practice Bring In Outside Migration Help?
Bring in experienced help when the deadline is compressed, the practice has multiple locations or many roles, billing combinations are complex, open A/R is material, interfaces or custom workflows are involved, internal leaders can’t step away from daily work, or neither vendor owns validation across the whole process. Whoever you bring in should deliver working controls and finished tasks. A diagnosis on its own isn’t enough.
Sources And Further Reading
We reviewed official documentation for this guide. Vendor features, terms, timelines and prices can change, so check the current documentation and your written agreement before relying on any of it. Reddit links are labeled as anecdotes, not authoritative evidence.
- ASTP/ONC Health IT Playbook, data migration and switching EHRs
- ASTP/ONC: Electronic Health Information export criterion
- ASTP/ONC: API Conditions and Maintenance of Certification
- ASTP/ONC: SAFER Guides
- HL7: FHIR overview
- HHS OCR, access to PHI maintained by a business associate
- HHS OCR, sample business associate agreement provisions
- CMS: Medicare Claims Processing Manual, Chapter 24: EDI
- SimplePractice, exporting client information through data exports
- TherapyNotes, importing client information
- TherapyNotes, account termination and record disposition
- Sessions Health, importing data from a different EHR
- Reddit anecdote, changing EHRs with a large caseload
- Reddit anecdote, questions about schedules and record transfer
Next Step
Know What This Would Cost For Your Practice.
Every service has a published price and a written scope. If you are not sure which one fits, ask and you will be pointed at the right one.