Migration Checklist
QuickBooks Desktop to Online Migration Checklist (2026)
A complete, step-by-step checklist for migrating from QuickBooks Desktop to QuickBooks Online. Work through each phase in order. Check off items as you go — progress is saved in your browser.
Overall progress0 of 35 complete
1
Pre-Migration — QuickBooks Desktop
Complete these before taking your snapshot
Data Integrity
- Run File → Utilities → Verify DataRequiredFix any errors before proceeding. A damaged company file will produce an unreliable snapshot.
- Reconcile through the most recent periodUnreconciled transactions create discrepancies that follow you into QBO and are harder to trace post-migration.
- Review all open invoices and unpaid billsConfirm AR and AP balances are correct. These become your starting reconciliation point in QBO.
- Identify unlinked BillPaymentsBillPayments with no linked Bills cannot be migrated via the QBO API — they must be entered manually post-migration.
- Review inventory adjustmentsIf inventoryInventory Adjustments cannot be migrated via QBO API. Document them for manual entry post-migration.
- Note all Group / Bundle itemsIf Group itemsQBO Bundles must be created manually. List your Group items with their components and quantities.
- Document which states you collected sales tax inIf sales taxYou'll need this to configure Automated Sales Tax (AST) in QBO before migration.
Migration Decision
- Choose migration mode: Safe Start or Full HistorySafe Start = migrate from a cutover date (recommended for most). Full History = all transactions from inception (requires variance review).
- If Safe Start: choose your cutover dateTypically Jan 1 of current year. All transactions from this date forward will migrate. Prior history seeded via opening balance JE.
2
Pre-Migration — QuickBooks Online Setup
Configure QBO before importing anything
- Create a new, empty QBO companyRequiredMigration must go into a blank QBO company. If the company has existing transactions, they will conflict with migrated data.
- Enable Automated Sales Tax (AST)If sales taxGo to Taxes → Sales Tax in QBO. Enable AST and configure the states you collected tax in. This must be done before any transactions are imported.
- Enable ShippingIf shipping chargesSettings → Account and Settings → Sales → Shipping. Required if any QBD invoices include shipping lines.
- Confirm QBO subscription includes required featuresInventory requires QBO Plus or higher. Payroll requires a separate QBO Payroll subscription.
- Note QBO company ID (realm ID) for OAuthFound in QBO URL: qbo.intuit.com/app/homepage?companyId=XXXXXXXXX. You'll need this to connect MigrationClarity.
3
Snapshot & Assessment
Know your complexity before committing
- Download qbdsnapshotNewDownload here — Windows only. Runs against your local QBD installation.
- Open QuickBooks Desktop with your company fileqbdsnapshot requires QBD to be running and connected to the company you want to migrate.
- Run qbdsnapshot — double-click the exeTakes 2–5 minutes. Outputs qbdsnapshot.json to your Desktop when complete.
- Upload snapshot to MigrationClarityGo to thereconciliator.com/migrate, upload qbdsnapshot.json. Complexity scored in under 2 minutes.
- Review complexity score and flagsNote your score and tier. Review the specific complexity flags — inventory, payroll, bundles, unlinked BillPayments.
- Unlock full Migration Assessment ($50)Full trial balance comparison preview, confidence signal, variance explanations, payroll summary, and PDF report.
Upload your snapshot and get your complexity score
Upload Snapshot →No account required · Results in under 2 minutes · $50 to unlock full report
4
Migration Execution
Run the migration — entities migrate in dependency order
- Confirm QBO company is empty before startingAny existing transactions will conflict with migrated data. Start fresh.
- Connect to target QBO company via OAuthAuthorize MigrationClarity to write to your QBO company. Connection is session-only — no credentials stored.
- Run the Audit — review what will be createdThe audit scans QBO and maps what already exists. Review entity counts before migrating.
- Create QBO Bundles manually (if applicable)If Group itemsQBO Bundles cannot be created via API. Create them in QBO first, then Re-Audit before migrating transactions.
- Run migration — monitor for failuresWatch for API errors. If a run fails, Re-Audit and restart — already-migrated records are detected and skipped automatically.
- Confirm zero failures in migration reportEvery entity type should show zero failures. Investigate any failures before proceeding to validation.
5
Validation
Do not go live until this phase is complete
- Review Migration Confidence SignalRequiredHigh (green) = safe to proceed. Review Required (red) = do not go live — investigate unexplained variances first.
- Review trial balance comparison — QBD vs QBOEvery account should be explained. Unexplained variances must be investigated before going live.
- Confirm all known variances are accounted forInventory Asset, Sales Tax Payable, AP variance from unlinked BillPayments — all documented and expected.
- Verify open invoices and bills in QBOAR and AP balances should match QBD. Check aging reports in both systems.
- Verify bank account balancesChecking, savings, and credit card balances should match QBD exactly.
- Download Migration Report PDFSave for your records. Share with your accountant or CPA for review.
6
Post-Migration Cleanup
Complete before going live
- Enter skipped BillPayments manuallyIf applicableThe Migration Report lists every skipped BillPayment with vendor name and amount. Enter in QBO to fully reconcile AP.
- Enter Inventory Adjustments manuallyIf inventoryInventory Adjustments cannot be migrated via API. Enter in QBO to match QBD inventory quantities.
- Re-mark billable expense linesIf billable linesBills with billable expense lines were migrated as NotBillable. Re-mark applicable lines with the correct customer in QBO.
- Verify Undeposited FundsConfirm payments are applied correctly and create deposits to clear Undeposited Funds.
- Set up payrollIf payrollProvide YTD figures from the Payroll Transition Summary to your payroll provider. Set up QBO Payroll or third-party service with correct YTD starting balances.
- Review equity accountsVerify owner draws, contributions, and retained earnings are correctly reflected after the opening balance JE.
- Reconcile first period in QBORun your first bank reconciliation in QBO to confirm starting balances are correct.
- Go live in QBO ✓Final stepStop entering transactions in QBD. QBO is now your system of record.
Need help with your migration? The $50 MigrationClarity assessment scores your complexity, previews your trial balance, and tells you exactly what to expect before you commit to migration.