# Import Your Chart of Accounts

***

### When to Use a CSV Import

If your client’s books were previously managed outside of Digits, for example, in Xero, Puzzle, or a custom spreadsheet, you can import their **Chart of Accounts (COA)** manually using a CSV file.

{% hint style="danger" %}
The CSV import adds your **Chart of Accounts only**. It does not import transactions or opening balances.

You can add opening balances later by **importing** or **manually creating journal entries** in the **Ledger**.
{% endhint %}

***

If you’re uploading a CSV manually, follow these steps:

1. Click your firm name in the top left corner to open the dropdown.
2. Click, **+ Add Client.**
3. Choose **Start Fresh** or **Migrate from another platform** (e.g., Xero, Puzzle).
4. Select Manual Upload, click **Next**.&#x20;
5. Complete the company profile and click **Next**.
6. Click **Download Template**.

<div align="left"><figure><img src="https://931519193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuIztBwoMl2RW5oGzS0cZ%2Fuploads%2FbUoCHkJYjp4KBISntUSS%2Fimage.png?alt=media&#x26;token=3652efbd-ab4f-468c-b9b5-2feacee23406" alt="" width="209"><figcaption></figcaption></figure></div>

5. Fill in the following fields for each category:
   * Category Name
   * Category Number
   * Category Type (Income, Expense, Asset, etc.)
6. Save your completed CSV.
7. Click **Upload CSV** to bring it back into Digits.
8. &#x20;Review the preview screen.
9. If everything looks good, click **Submit** to import.

***

### Filling Out the Template CSV

<table data-header-hidden><thead><tr><th width="153.0269775390625">Column</th><th width="236.470947265625">What to Enter</th><th>Tips &#x26; Examples</th></tr></thead><tbody><tr><td><strong>Category Name</strong></td><td>The account or category name.</td><td>Any text. This field <strong>can’t be blank</strong>. Avoid using commas or extra spaces. <br>✅ <strong>Example:</strong> Prepayments</td></tr><tr><td><strong>Category Number</strong></td><td>An optional account number.</td><td>Use your firm’s standard numbering system (if applicable). <br>✅ <strong>Example:</strong> 11110</td></tr><tr><td><strong>Parent Name</strong></td><td>Indicates if a category should be nested under another in the Category Manager (your chart of accounts).<br>• Use <strong>only</strong> for subcategories.<br>• Leave <strong>blank</strong> for top-level categories like <strong>Assets</strong>, <strong>Liabilities</strong>, or <strong>Revenue</strong>.</td><td>This field is <strong>optional</strong>, but if used, keep in mind:<br>• <strong>First-time uploads:</strong> The parent must appear in <strong>Column 1 (Category Name)</strong>. Placement in the file doesn’t matter.<br>• Use the <strong>exact name</strong> of the parent as listed in Column 1.<br>• If the parent already exists in Digits, <strong>don’t include it again</strong> — doing so may trigger a duplicate name error. <br>✅ <strong>Example:</strong> <img src="https://931519193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuIztBwoMl2RW5oGzS0cZ%2Fuploads%2FT3nE0NzXawIVDlqmMUWE%2Fimage.png?alt=media&#x26;token=305af7bd-204b-4756-8ec5-44478a1bf09b" alt=""></td></tr><tr><td><strong>Type</strong></td><td>The category’s financial type.</td><td>Must match one of the following exactly: Bank, Credit Card, Assets, Liabilities, Equity, Revenue, Cost of Revenue, Operating Expenses, Other Income, or Other Expenses. ✅ <strong>Example:</strong> Assets</td></tr><tr><td><strong>Status</strong></td><td>Active or inactive.</td><td>Optional — defaults to Active if left blank. <br>✅ <strong>Example:</strong> Active</td></tr><tr><td><strong>Description</strong></td><td>Optional short description.</td><td>Helps your team understand the purpose of the category. <br>✅ <strong>Example:</strong> Monthly rent and utilities</td></tr></tbody></table>

***

{% hint style="info" %}
**Tips:**&#x20;

* If your firm uses a standardized COA, save it as a **master CSV**. You can reuse it for future clients to maintain consistency and speed up setup.
* Expand **Row 2** in the template for built-in instructions.
* Remove all blank lines before uploading.
* Ensure **Category Type** matches one of Digits’ accepted types: *Assets, Liabilities, Equity, Revenue, Cost of Revenue, Operating Expenses, Other Income, or Other Expenses.*
  {% endhint %}

***

### Review and Adjust Categories

Once your import is complete:

1. From your client’s **Dashboard**, go to **Accounting → Category Manager**.
2. Review all categories for accuracy and completeness.
3. **Merge, rename, or deactivate** categories to align with your firm’s standard structure.
4. Add **subcategories** for improved organization and reporting.

For more details, see: [Category Manager (Chart of Accounts) ](https://help.digits.com/firms-agentic-general-ledger/category-manager)

***

### My Client is Already Set Up — How Do I Bulk Import Categories?

The steps above apply when importing a Chart of Accounts during initial client setup.

If you need to upload or modify categories later — for example, to restructure an existing client’s accounts — use **Bulk Importing Categories** from the Category Manager instead.

See: [Bulk Importing Categories](https://help.digits.com/firms-agentic-general-ledger/category-manager)&#x20;

***

### Frequently Asked Questions

<details>

<summary>Do I have to use the Digits CSV template?</summary>

Yes. All uploads must follow the official **Digits CSV template** to ensure proper formatting and field recognition.

</details>

<details>

<summary>How should I handle parent and child categories?</summary>

* Ensure parent categories are added as a separate row in the CSV file or already exist in your chart of accounts in Digits (i.e., if this is not a first-time category upload) and are correctly named.
* Ensure to leave this field blank if the parent is one of the following top-level categories: Assets, Liabilities, Equity, Revenue, Cost of Revenue, Operating Expenses, Other Income, Other Expenses

</details>

<details>

<summary>What formatting rules should I follow?</summary>

* Keep the **header row** intact — do not rename or delete it.
* Expand **Row 2** in the template for built-in field instructions.
* Remove any blank lines at the end of your file before uploading.
* Save the file in **.csv** format before uploading.

</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://app.gitbook.com/s/x8QKZsFt122QPdcslRDC/contact-us" class="button primary" data-icon="envelope-open-text">Contact Digits Support</a></p>
{% endcolumn %}
{% endcolumns %}

***

<details>

<summary>Can I apply the same Chart of Accounts to multiple clients at once?</summary>

Not all at once. Right now, you can’t push one Chart of Accounts to every client in a single step.

The easiest workaround is to use the same COA CSV file for each client. Import that CSV into each client’s Category Manager. Once your template is set up, repeating the import is quick.

</details>

<details>

<summary>Is the AI-generated Chart of Accounts GAAP compliant?</summary>

Digits’ auto-generated COA is GAAP-aligned in structure, but GAAP compliance depends on how entries are recorded (depreciation, accruals, adjusting entries).\
If you have a preferred GAAP template (by industry/firm standard), you can import your own COA via CSV.

</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://app.gitbook.com/s/x8QKZsFt122QPdcslRDC/contact-us" 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-agentic-general-ledger/import-coa.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.
