# Migrate Data from QuickBooks Online (QBO)

{% hint style="danger" %}
**Important:** QuickBooks migration is only available during **initial client setup.** Once a client is created without this option, the import can’t be retroactively added.
{% endhint %}

***

### How to Migrate a Client from QuickBooks Online

{% hint style="info" %}
&#x20;**Tip:** If your client’s QuickBooks file hasn’t been reconciled recently, complete that step before migrating. This ensures clean data and accurate cutover balances.
{% endhint %}

Follow these steps during your client’s initial setup:

1. From your **Firm Dashboard**, click **+ Add Client** and enter their basic information.
2. When prompted to choose a setup option, select **QuickBooks**.

<div align="left"><figure><img src="/files/QSI0xCrHvy48T71iuWyR" alt="" width="206"><figcaption></figcaption></figure></div>

3. Log in to your client’s **QuickBooks Online** account and authorize the connection.
4. **Set a cutover date**—this tells Digits when to take over as the system of record.&#x20;

{% hint style="info" %}
We recommend the day after your client’s last fully reconciled period. See: [Cutover Date](/firms-getting-started/firms-quickbook-cutover-date.md) for more information.
{% endhint %}

3. Digits automatically imports your client's:

* Transactions
* Balances
* Chart of Accounts

All data prior to the cutover date is pulled in for historical reference. Afterward, the QuickBooks connection is archived and no longer syncs. From that day forward, **Digits** becomes your system of record.

{% hint style="warning" %}
Once the import is complete, review in [**Category Manager**](/firms-agentic-general-ledger/category-manager.md) to confirm your Chart of Accounts has been imported correctly.
{% endhint %}

**Next Step:** \
Once your client’s data has been imported and reviewed, continue setting up their workspace:

* [**Connect Banks & Apps** ](/firms-connections/firms-connections.md)
* **Confirm Billing** for your firm
* [**Invite Client Team Members**](/client-management/roles-and-permissions.md) to collaborate in Digits

***

### What Migrates to Digits from QBO and What Doesn't?

:white\_check\_mark: **Migrates:**

* **Transactions** *(your historical activity)*
* **Journal Entries** **(JEs)** *(included in your transaction history)*
* **Chart of Accounts** **(COA)** *(maps to the Category Manager in Digits)*
* **Classes and Locations** from QBO *(you’ll map these during setup to Digits Departments and Locations to use them)*
* **Vendors**
* **Customers** *(imported and surfaced during Invoice creation)*
* **Products** *(imported and surfaced during Invoice creation)*

{% hint style="info" icon="lightbulb-on" %}
Products with a **unit price greater than $0** appear in the **Product selection dropdown** \
Products with a **unit\_price equal to or less than $0** appear as **Discount options** when creating an invoice&#x20;
{% endhint %}

:no\_entry\_sign: **Does NOT Migrate:**&#x20;

* **Reconciliation status** *(whether a transaction was previously marked reconciled in QBO)*
* **Reconciliation history** *(past statement periods and reconciliation reports)*

***

### What Happens After Migration?

* Your client’s QuickBooks categories and balances are now live in Digits.
* :sparkles: Digits will begin categorizing new transactions automatically based on your imported data.
* The QuickBooks connection remains archived for reference, but won’t update.

{% hint style="info" %}
**Tip:** After migration, check that your client’s **opening balances** match the final reconciled figures from QuickBooks. Adjust as needed using **Journal Entries** in the **Ledger.**
{% endhint %}

***

### Running a Parallel Close

If you’d like to test **Digits** while still closing your books in **QuickBooks**, you can run a **parallel close** for your first month.

This lets you compare results between both systems before fully switching to Digits.

See:  [Running a Parallel Close](/firms-getting-started/parallel-close.md)

### Frequently Asked Questions

<details>

<summary>Can I migrate a client after setup?</summary>

No. QuickBooks migration is only available during the **initial setup** of a new client in Digits.

</details>

<details>

<summary>Do Departments and Locations (Classes) import from QuickBooks?</summary>

Yes. When you migrate from QBO, you can import both Locations and Line Classes — but you'll need to map them during the import setup, since QBO and Digits use different terminology.

QBO uses a generic structure for these fields, while Digits defines them more specifically as Departments and Locations. During setup, you'll select which QBO field maps to which Digits dimension.

Common mapping:

* QBO Location (or custom name like "Business") → Digits **Departments**
* QBO Line Class → Digits **Locations**

</details>

<details>

<summary>Do products import from QuickBooks?</summary>

Yes, products are imported from QBO — but they only apply if you're using Digits Invoicing to create and manage invoices. If you're not using Invoicing, imported products won't affect your setup.

</details>

<details>

<summary>Why aren't my transactions tagged with Departments or Locations after migration?</summary>

Transaction tags won't appear until you've mapped your Departments and Locations. Here's how to do it:

1. In the left navigation, go to **Accounting → Departments** (or **Locations**).
2. Click **Import Departments** (or **Import Locations**) and follow the steps to map your QBO fields to the correct Digits dimension.

Once saved, Digits retroactively applies the tags to all matching historical transactions.

See: [Departments](/firms-agentic-general-ledger/departments.md) | [Locations](/firms-agentic-general-ledger/locations.md)

</details>

<details>

<summary>Does Digits overwrite QuickBooks data?</summary>

No. Digits reads data from QuickBooks (up to the cutover date) but never pushes updates back.

</details>

<details>

<summary>Are QuickBooks transactions editable after migration?</summary>

Yes. All data imported up to your **cutover date** is editable in Digits. Any changes made in QuickBooks after that date will not sync.

</details>

<details>

<summary>What if I choose the wrong cutover date?</summary>

You can delete the client and restart setup with the correct date, or manually adjust opening balances in the Ledger.

</details>

<details>

<summary>Why am I seeing “The app you’ve selected isn’t available for use in your country”?</summary>

This occurs when your **QuickBooks Online** account was created outside the U.S. Digits’ QuickBooks integration currently supports **U.S.-based accounts only.**\
If you have a U.S.-based QuickBooks account, connect that one instead.\
For non-U.S. accounts, you can still use Digits by importing transactions via CSV.

We know international support is important, and expanding availability is on our roadmap. If you have questions, contact <help@digits.com>.

</details>

<details>

<summary>Why Migrate from QuickBooks to Digits?</summary>

Many accounting firms start on **QuickBooks**, but as their client base and complexity grow, they quickly feel its limits. QuickBooks was built for small business owners — not for firms managing many clients, staff, and data sources at scale.

As your workload expands, QuickBooks often creates bottlenecks with:

* Rule-based categorization that requires constant maintenance
* Manual reconciliations that slow down month-end closes
* Static reports that need exporting or refreshing
* Limited visibility across multiple clients

✨ **Digits removes those limits.**

Firms switch to Digits for automation, scalability, and real-time insights — all powered by Digits’ AI-native ledger. Here’s what that brings to the table:

* **Automated Categorization:** Transactions classify themselves intelligently with accuracy that improves over time.
* **Continuous Reconciliation:** Bank and credit card reconciliations run automatically in the background, catching issues early.
* **Live, Connected Reporting:** Reports update instantly across every client without exports or delays.
* **Firm-Level Efficiency:** Manage every client from one dashboard.
* **Client Collaboration:** Comment, share, and review directly inside Digits — no email threads or version confusion.

In short, firms migrate from **QuickBooks to Digits** to gain automation, accuracy, and modern scalability through an AI-native accounting platform that truly keeps up with their growth.

</details>

<details>

<summary>Is it safe to run Digits alongside QuickBooks Online? </summary>

Yes. Digits' QuickBooks migration is a **one-time data pull** — it copies your client's data without modifying or syncing back to your QBO file. Your QuickBooks data remains fully intact.

You can continue using QBO as your primary system while testing Digits in parallel, comparing reports, and verifying accuracy before fully committing. Once you're confident everything aligns, you can transition to Digits and cancel your QBO subscription. See: [Running a Parallel Close](/firms-getting-started/parallel-close.md)

</details>

<details>

<summary>How do I migrate data from QuickBooks Desktop 10? </summary>

See: [Migrate to Digits from Xero, Puzzle, or Another Platform](/firms-getting-started/migrate-to-digits.md)

</details>

***

{% columns %}
{% column width="66.66666666666666%" valign="middle" %}
Got a question or feedback? Our team is all ears—come say hello!
{% endcolumn %}

{% column width="33.33333333333334%" valign="middle" %}

<p align="center"><a href="https://portal.usepylon.com/digits/forms/get-in-touch-with-digits-support" class="button primary" data-icon="envelope-open-text">Contact Digits Support</a></p>
{% endcolumn %}
{% endcolumns %}

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.digits.com/firms-getting-started/migrate-from-quickbooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
