> For the complete documentation index, see [llms.txt](https://help.digits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.digits.com/firms-getting-started/adding-additional-entities-to-a-client.md).

# Adding Additional Entities to a Client

If a client runs more than one business, add each one as its own entity under that client. Every entity has its own books, connections, and plan, and shares the client's login, team, and subscription.

***

### How Clients and Entities Fit Together

Each client in Digits is an **organization**, and each organization holds one or more **entities**:

* **The client organization** is the client's Digits account. It holds the client's login, their team, and their subscription. Each client has one.
* **Entities** are the sets of books inside that organization. Each one has its own transactions, categories, connections, reports, and plan. A client can have as many as they need.

In Digits, each of a client's businesses is an **entity**. An entity can't contain other entities; they all sit side by side under the client's organization.

{% hint style="warning" %}
**Why does the client's organization have the same name as its first entity?** When you add a client, Digits names the organization after the first entity you create. On your Firm Dashboard, that name is the client's row, with each entity listed underneath it. Your client can rename the organization anytime in their **Organization Settings**.
{% endhint %}

{% hint style="info" icon="lightbulb-on" %}
**New client or new entity?** Use **Add Client** when the business belongs to a different owner. Use **Add Entity** when the business belongs to a client you already have, so it shares that client's login, team, and subscription. If you add it as a separate client by mistake, the owner ends up with two Digits accounts and two bills. See [Setting Up Your Firm & Adding Your First Client](https://help.digits.com/firms-getting-started/adding-your-first-client.md)
{% endhint %}

***

### How to Add an Entity to a Client

You need permission to add clients and manage your firm. From your **Firm Dashboard**:

1. Find the client in your client list.
2. Click the **menu** (three dots) at the right end of the client's row.
3. Select **Add Entity**.

<div align="left"><figure><img src="https://774908611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZJRjnc8NFWHCOqIwdbuI%2Fuploads%2FppVXVZC2K7amucWbZrCc%2FAdd%20Entity.jpg?alt=media&#x26;token=79f643b3-2e82-4fc6-acc4-c6ea2fe42cc3" alt="" width="563"><figcaption></figcaption></figure></div>

4. Enter the **Entity Name**, and optionally a website and logo. Click **Add Entity**.
5. Pick a plan for the new entity, then click **Next**.

You'll then land in the new entity's books, where you choose to start fresh or import its chart of accounts from QuickBooks, Xero, or another platform. The setup steps are the same as for the client's first entity. See [Migrate Data from QuickBooks Online](https://help.digits.com/firms-getting-started/migrate-from-quickbooks.md) or [Migrate to Digits from Xero, Puzzle, or Another Platform](https://help.digits.com/firms-getting-started/migrate-to-digits.md)

{% hint style="info" %}
**Don't see Add Entity, or is it grayed out?** Add Entity is only available on a client with an active subscription. If the client's first entity doesn't have a plan yet, finish setting it up first. Add Entity is also unavailable while a subscription payment is outstanding or a cancellation is scheduled.
{% endhint %}

***

### How Billing Works for a Client's Entities

All of a client's entities share one subscription, but each entity is on its own plan.

* **If your firm pays for the client,** the new entity is added to your firm's subscription. You won't be asked for payment details again. Your firm's billing address and payment method are already on file.
* **If the client pays,** the new entity is billed to the client's own subscription, using the payment method they already have on file. See [Client Pays in Digits](https://help.digits.com/client-management/client-pays-in-digits.md)

Whoever pays for the client's first entity pays for every entity you add to that client. You can't mix firm-paid and client-paid entities under one client.

#### Pricing for additional entities

The client's first entity stays on the plan you selected when you added the client. Each additional entity starts on **free Essentials** and stays free as long as it has 250 or fewer transactions in a calendar year. As the business grows past 250 transactions in a year, the entity moves to Essentials at a discounted **$35/month**, a rate that stays in place from then on. Imported history counts toward the first year's total.

Free Essentials is only available when adding a new entity to a client that already has a paid entity. It appears at the top of the plan list. You can't switch an existing entity to the free plan later.

You can upgrade individual entities to higher plans without affecting the others. For plan details, see [Digits for Firms Plans](https://help.digits.com/my-firm-account/firm-plans.md)

{% hint style="warning" %}
**Firm Books is for your own firm's books only.** Each firm can use it for one entity. Once a client is on Firm Books, you can't add other entities to it, and Firm Books isn't offered when you add a second entity to any client. See [Free Books for Your Firm](https://help.digits.com/my-firm-account/free-books.md)
{% endhint %}

***

### Finding a Client's Entities on Your Firm Dashboard

A client with more than one entity appears as a single row on your Firm Dashboard, with an arrow at the left. Click the arrow to expand the row and see each entity underneath it. The counts on the client's row add up the open items across all of its entities; the counts on each entity's row are for that entity only.

To open an entity, click its row, or click your firm name in the upper left and select it from the list.

***

### Giving the Client's Team Access to a New Entity

The client's team members already belong to the client's organization, so you don't invite them again. Each person's **Default entity role** decides whether they can see a new entity automatically. The client's Admins can change what someone can do on the new entity from their **Manage Team** page. See [Invite a Client to their Digits Account](https://help.digits.com/client-management/roles-and-permissions.md)

Your firm's colleagues get access to the new entity based on their firm role. See [Firm Roles & Permissions (Invite Colleagues)](https://help.digits.com/my-firm-account/roles-and-permissions.md)

***

### Removing One of a Client's Entities

You can remove a single entity without affecting the client's other entities. From your **Firm Settings**:

1. Click the **Clients** tab.
2. Find the entity and open its **menu** (three dots).
3. Select **Remove**, enter a reason, and confirm.

The entity is archived. Your firm and the client lose access to it right away, but its data is retained. The client's other entities, their billing, and their access aren't affected.

To remove a client entirely, see [Adding & Removing Client Accounts](https://help.digits.com/client-management/adding-and-removing-client-accounts.md)

***

### Moving an Entity to Another Client

If you added a business as its own client by mistake, you can move it under the client it belongs to.

#### Before You Begin

* You need permission to add clients and manage your firm.
* Your firm must pay for the entity. Client-pays entities can't be moved.
* The client you're moving it to must already have an entity your firm pays for.
* Entities with another affiliated firm can't be moved, and you can’t move an entity to or from a client on a legacy plan.

#### Step 1: Contact Digits Support

Email <help@digits.com> and ask us to turn on **Move Entity** for your firm. Include the entity you want to move and the client it should go under.

#### Step 2: Move the Entity

From your **Firm Dashboard**:

1. Find the entity's row. If the client has more than one entity, click the arrow on the client's row to see its entities.
2. Click the **menu** (three dots) at the right end of the entity's row.
3. Select **Move Entity**.
4. Under **Choose an organization to move to**, select the client to move it to.
5. Click **Move**.

#### What Happens After the Move

* **The books move with it.** The entity keeps its own books.
* **The plan and billing stay the same.** The entity keeps its current plan, and your firm keeps paying for it. To change its plan, contact [Digits Support](mailto:help@digits.com).
* **Bill approvers are removed.** If the entity had a bill approver, assign a new one after the move.

{% hint style="info" %}
✨ **Good to know:** Moving an entity doesn't merge its books with the client's other entities. Each entity keeps its own books under the same client.
{% endhint %}

***

### Frequently Asked Questions

<details>

<summary>Can an entity have other entities inside it?</summary>

No. Digits has two levels: the client's organization, and the entities inside it. Every entity sits directly under the organization.

</details>

<details>

<summary>Can I see a client's entities combined in one report?</summary>

Not in Digits yet. Multi-entity groups a client's entities under one organization, but each entity reports on its own. For consolidated reporting across entities, use our partner [Reach Reporting](https://digits.com/blog/reach-reporting/), which works with multiple Digits entities today.

</details>

<details>

<summary>Does my client need a separate login for each entity?</summary>

No. One login covers every entity in the client's organization. After they sign in, they land on their Organization Dashboard, where each entity appears as a card. See [Multi-Entity: Run Several Businesses Under One Account](https://help.digits.com/my-business-account/add-additonal-businesses.md)

</details>

<details>

<summary>Can my client add an entity themselves?</summary>

No. When a firm manages a client, Add Entity is unavailable in the client's organization, and they're prompted to speak with their accountant. Add the entity from your Firm Dashboard.

</details>

<details>

<summary>Is there a settings page for the whole client organization?</summary>

Not on the firm side yet. Each of a client's entities appears as its own row in **Firm Settings → Clients**, with its own plan, colleagues, and permissions. Your client can manage organization-wide settings, like their team and payment method, from their own **Organization Settings**.

</details>

<details>

<summary>What happens when an additional entity goes over 250 transactions?</summary>

It moves to Essentials at a discounted rate of $35/month and stays at that rate from then on. The limit is per entity, per calendar year, and imported history counts toward the total.

</details>

<details>

<summary>Can I upgrade just one of a client's entities?</summary>

Yes. Each entity has its own plan. See [Upgrade/Downgrade a Client Plan](https://help.digits.com/client-management/upgrade-downgrade-a-client-plan.md)

</details>

<details>

<summary>Can I move transactions from one entity to another?</summary>

Each entity keeps its own books, so transactions can't be moved between them. To get everything in the right place, connect the bank or card to the correct entity, or import the transactions there and remove them from the original entity.

</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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.digits.com/firms-getting-started/adding-additional-entities-to-a-client.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
