> For the complete documentation index, see [llms.txt](https://docs.filed.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.filed.com/reference/clients/adding-clients-in-bulk.md).

# Adding clients in bulk

**Add clients** lists the clients in your tax software next to the matching clients in your other connected systems, so you can bring them all into Filed in one import, documents included.

## Before you start

Connect the systems your clients live in under **Plugins**. Bulk import works with:

| Kind                                                                   | What it provides                                                                                |
| ---------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Tax software                                                           | The client list, each client's return type, and the link Filed uses for data entry              |
| Practice management (Karbon, Truss, Double)                            | A client list and the documents stored on each client                                           |
| Storage (SmartVault, Google Drive, SharePoint, OneDrive, Box, Dropbox) | One client per folder, and the files inside it                                                  |
| Accounting (Digits)                                                    | Your firm's client list in Digits, linked so Analyst works in each client's books; no documents |

## The table

Open **Clients**, then **Add clients**.

* Each row is a client, whichever system it comes from: your tax software, practice management, storage, accounting, or Filed itself.
* Each connection has its own column: tax software first, then storage, then practice management, then accounting. Filed fills the columns by matching names, so "Smith, John" and "John Smith" land on the same row.
* A storage connection gets a column once you open **Sources** (the columns button in the toolbar), press **Choose folder…** next to it, and pick the folder that holds one folder per client. Filed remembers the folder on this browser; **Change folder…** in the same menu picks a different one.
* **Synced 2h ago** under a column name is when Filed last read that list. Press the refresh button beside the name to read it again.
* Clients in your tax software are listed first, then clients matched in more than one system, then the rest, each in alphabetical order. An empty cell means nothing is matched yet; hover over the row and press **Add match** to pick a record.
* Every row starts unticked. Tick the clients you want to bring in. To tick a run of rows, tick the first, then hold Shift and tick the last. The checkbox in the table heading ticks everything shown. With more than one connection, **Quick select** ticks the clients matched in more than one system that are not in Filed yet.

Two tabs above the table split the list:

* **Not imported** lists the clients that are not in Filed yet. The screen opens here.
* **Already imported** lists every client you already have, with a cell for each system it is linked to. They start unticked; tick one to add documents to it or to link it to another system.

More tabs appear beside them only when they have something in them: **Suggested**, **Needs attention**, **New from Digits**, which lists Digits clients added in the last week that are not in Filed yet, and **Selected**, which lists every client you have ticked so you can review them before importing.

Searching looks through both tabs.

**Sources** turns connections on and off. A connection that is turned off is left out: its column, its clients, its matches and its files all go away until you turn it back on. Your ticks and other choices are kept. Filed remembers which connections are off.

## Fixing a match

Click a cell to change which record sits on that row. The closest names are listed first, and you can search for any other. To take a record off a row, hover over the cell and press the ✕, or choose **No match** in the list. Rows stay where they are while you match; the list is re-sorted when you change tab or search.

To join two rows that are the same client, hover over the empty cell on one of them, press **Add match** and pick the other row's record. This also links a client already in Filed to its record in another system.

### Suggested matches

Names that are close but not identical, such as "Bob Johnson" and "Johnson, Robert", are not joined automatically. Filed shows them as suggestions instead: the likely record appears in italics in the cell with two buttons.

* The tick confirms it is the same client, puts the record on that row and ticks the row for import. You will find it under **Selected**.
* The cross says it is not, and the suggestion goes away.

The **Suggested** filter lists every row with a suggestion, and **Accept all** confirms them together. Check the list first: a suggestion is a likely match, not a certain one. Nothing suggested is imported until you confirm it.

## Return type and tax year

The tax year for the whole import is set in the year picker beside the search box.

The **Type** column shows each client's return type. When your tax software supplies it, or the client is already in Filed, it cannot be changed here. Otherwise the row uses the **Default return type** from **Import settings**, and you can pick a different one in the row. Return type cannot be changed after import.

## Clients already in Filed

Rows under **Already imported** match clients you already have. Open one and the panel asks **What should Import do?**:

* **Add to** the client in Filed. Each option shows that client's return type, how many documents it has and which systems it is linked to, so two clients with the same name can be told apart. Pick documents in the panel to add them to it.
* **Create a new client**, when the row is a different person or business with the same name.
* **Leave out of this import**.

To link clients to another connection to the same tax software, such as a colleague's Drake desktop, turn that connection on under **Sources**, open **Already imported** and tick the clients. **Update** links each one to every connection it is not on yet and changes nothing else about it.

If you tick a client already in Filed without choosing anything new for it, the import creates another client with the same name, and the row is flagged **Already in Filed** so you can see it first. Untick it to leave it out.

### Same name, more than one record

When one of your systems has several records with the same name and Filed has one client of that name, only one of those records is treated as that client: the one in your tax software, or the one matched in the most systems. The others are listed under **Not imported** as separate clients. If Filed picked the wrong one, use **No match** and **Add match** to move the client to the right record.

### Archived clients

A client you archived in Filed is not listed. If one of your systems still has a record for it, the row appears under **Already imported**, greyed out and marked **Archived**, with no checkbox, so an import never adds anything to it. Open the row and press **Unarchive** to bring the client back; the row then behaves like any other.

### Needs attention

A yellow flag under a ticked row's name marks something to check. Most flagged rows are still imported:

* **Matches 2 clients in Filed.** More than one client in Filed has this name, so the import creates a new one. To add to one of them instead, choose it in the panel.
* **Already in Filed.** There is nothing new to add, so the import creates another client with the same name. Untick it to leave it out.

Two rows are held back until you change them:

* **Nothing chosen to add.** You chose a client already in Filed, but there is nothing new for it. Pick or upload documents, create a new client instead, or untick it.
* **No tax software or document source.** Filed creates a client from a record in your tax software or a document source. Add a match in one of those, or untick it.

The **Needs attention** tab lists every flagged row.

## Choosing documents

Click a row to open its details in a panel on the right. Drag the panel's edge to resize it, and close it with the ✕. With one connection, the client's record in it is shown under the name; with more, the panel lists each connected system with what it is matched to. For a client that matches one in Filed, the panel asks what the import should do (see [Clients already in Filed](#clients-already-in-filed)); for any other, it says **Creates a new client** or **Not in this import**. Below that, it lists the client's files by source:

* Files with the tax year in their name or folder start selected.
* Tick or untick files or whole folders.
* Press **Upload files** to add documents from your computer. This also works for a client with no matched source.
* Adding files to a client that is not ticked includes it in the import.

Only clients you open have their files listed. A client you never open is imported without documents, and you can add them later from its [Files panel](https://docs.filed.com/reference/clients/managing-files.md).

## Import settings

**Import settings**, the sliders button in the toolbar, holds what applies to every client in the import:

* **Default return type** is used for clients whose source does not supply one.
* **Keep folders in sync** can be turned on once a storage column is matched. Filed links each client to its folder and keeps bringing in new files. See [Managing files](https://docs.filed.com/reference/clients/managing-files.md#auto-sync-from-a-storage-folder).
* **Assign to** assigns the chosen team members to every client the import creates. See [Assigning clients](https://docs.filed.com/reference/clients/assigning-clients.md).

## Importing

The button shows what will happen: **Import 42 clients** for new clients, **Update 3 clients** when only clients already in Filed are ticked, or **Import 42 clients · update 3** for both. Press it to start.

* **Clients are added first.** Every client in the import appears in your client list within moments, with its return type, links and assignees.
* **Documents follow.** Filed then brings in the documents for every client that has files chosen. A progress bar at the top of the table shows how far it has got, for example "Bringing in documents · 14 of 40 clients", with the clients being worked on named underneath. Each row's **Docs** column shows where that client is: waiting, in progress, or failed, and when it finishes, how many documents were added. **Nothing new** means Filed already had every document you chose. A client still waiting for its documents shows as processing in your client list, the same as one whose documents are being read.
* The import runs on Filed's side. You can leave the page or close the tab, and progress is shown when you come back.
* **Cancel** stops what has not started. Clients already added stay; documents not yet brought in are skipped.
* If a client's documents could not all be brought in, the notice names it and its row shows **Failed**; hover over that to see why. **Retry failed** runs only those.

Each imported client with documents starts building its Binder straight away.


---

# 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://docs.filed.com/reference/clients/adding-clients-in-bulk.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.
