> ## Documentation Index
> Fetch the complete documentation index at: https://help.dash.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Import a chart of accounts from a file

> Upload your GL accounts from a CSV file to code card transactions and bills to your own chart of accounts without connecting an accounting platform.

If you don't connect an accounting platform, you can import your chart of accounts from a CSV file instead. Dash.fi then lets you code card transactions and bills to your own GL accounts, and exports carry each expense's and bill line's GL account.

Use this when your ledger isn't one of the [supported platforms](https://help.dash.fi/integrations/accounting.md#supported-platforms), or when you want GL coding before you set up a live sync.

> [!NOTE]
>
> The **Chart of accounts** panel appears under **Settings → Integrations → Accounting** only when the Accounting product is enabled and you don't have a live accounting platform connection.

## Permissions

| Action | Required permissions |
| - | - |
| Start an import | `bulk-import-file-source:write` and `gl-account:write` |
| Archive or reactivate accounts | `gl-account:write` |
| Review past imports under **Imports** | `bulk-import:read` |

Users without `gl-account:write` can still open the account list with **View accounts**.

## Prepare your file

Each row in the CSV is one GL account with two required columns:

| Column | Description |
| - | - |
| **Account number** | The number exactly as it appears in your ledger, for example `949410.10`. Dash.fi keeps the value as entered, so `949410.10` never becomes `949410.1`. Each number must be unique in the file. |
| **Account name** | The account's display name. |

```csv chart-of-accounts.csv theme={null}
Account number,Account name
6000,Advertising
6100,Software subscriptions
949410.10,Travel - Airfare
```

You can download a template from the import wizard, or upload an export from your ledger. If you use a ledger export, remove any title rows above the header row. You map the columns in the wizard.

## Import your accounts

1. Go to **Settings → Integrations** and select **Accounting**.
2. In the **Import chart of accounts** panel, click **Import**. If you've already imported accounts, click **Import accounts**.
3. Download the `chart-of-accounts.csv` template if you need it, then upload your file.
4. Map your file's columns to **Account number** and **Account name**.
5. Review the accounts. The **Change** column shows what each row does:
   * **Added**: a new account.
   * **Renamed**: an existing account number with a new name.
   * **Reactivated**: a previously archived account that the import makes active again.
   * **Unchanged**: an account that already exists with the same name.
6. Fix any rows flagged with errors, such as a missing or duplicate account number, then process the import.

Dash.fi applies the import in the background. When it finishes, Dash.fi shows **Chart of accounts updated** with a **Map accounts** shortcut to **Accounting → Rules**.

Each import adds new accounts or renames existing ones by account number. Importing a file never removes accounts. To stop using an account, archive it.

## Manage imported accounts

After your first import, the **Settings → Integrations → Accounting** panel shows the number of active and archived accounts, with these actions:

* **Import accounts**: run another import to add or rename accounts.
* **Manage accounts**: search the list and click **Archive** or **Reactivate** on any account.
* **Map accounts**: open **Accounting → Rules** to map spend categories and merchants to your accounts.
* **Imports**: view your import history.

Mappings to an archived account stop applying until you reactivate the account or import it again.

### Import history

**Imports** groups your imports into three tabs:

* **File uploads**: files that are still uploading or processing.
* **Review import**: imports that are ready for you to review and process.
* **Completed**: imports that have finished.

## Code transactions with imported accounts

Once your accounts are imported, you can use them wherever Dash.fi asks for a GL account:

* **Accounting → Card Transactions**: pick an account in the GL column for each transaction. See [Coding transactions](https://help.dash.fi/expense-management/coding-transactions.md#gl-code).
* **Accounting → Rules** and **Accounting → Categories**: map spend categories and merchants to imported accounts so the GL code fills in automatically.
* **AI suggestions**: Dash.fi suggests imported accounts for your spend categories and merchants.
* **Bills**: code bill line items to imported accounts.

Without a live sync, Dash.fi doesn't post transactions to a ledger. Export coded transactions to bring the GL numbers into your accounting system.

## Switch to a connected accounting platform

To connect an accounting platform later, first remove your imported chart of accounts. Click **Remove chart of accounts** in the panel. This deletes every imported account, including archived ones, and every category and merchant mapping to them. Exports stop carrying GL accounts. Past imports stay in your import history. You can't undo this.

Then follow the setup guide for your [accounting platform](https://help.dash.fi/integrations/accounting.md#get-connected).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.