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

# Link your custodian accounts to clients

> Link each account your firm's custodian connection reads to a client in Tilt, make a client from one, unlink an account, and trade an account an outside manager runs.

Once your firm [connects its custodian](https://docs.tilt.now/advisor/connect-custodian.md), Tilt reads the firm's accounts from it. A custodian account belongs to no client until you link it to an account in Tilt. After the link, Tilt shows the account's holdings under that client, reviews the account, and can trade it.

## Who can do what

| Action | Who can do it |
| - | - |
| Link and unlink custodian accounts | Firm owners |
| Mark an account as traded by the firm | Firm owners and editors |

Tilt Agent can't link or unlink an account for you.

## 1. Open the list of custodian accounts

On **Clients**, select **Link custodian accounts**. The button appears for firm owners once the firm has a custodian connection.

![Top of the Clients page with the buttons Guide, Link custodian accounts, Upload clients, and Add client.](https://mintcdn.com/tilt/uNVzTB5L2kPYfwau/images/advisor/custodian-link-button.jpg?fit=max\&auto=format\&n=uNVzTB5L2kPYfwau\&q=85\&s=d211948473990c476eaacc50599edb6b)

Link custodian accounts sits in the Clients page's action row.

The dialog lists every account your firm's connections read, under **Not linked** and then **Linked**. Each row shows the account's name at the custodian, such as Roth IRA ...8203, and **Account holder:** with the name the custodian reports. A row can also show why the custodian limits trading in the account. That doesn't stop you linking it.

## 2. Fill the rows with suggestions

> [!WARNING]
>
> Tilt never suggests an account that is already in Tilt. If you added clients by hand or by upload before you connected the custodian, a **New client** suggestion makes a second client beside the one you have. For those accounts, [pick the client yourself](#3-pick-a-client-yourself) with **Link to an account already in Tilt** or **Add to an existing client**.

When Tilt has a suggestion for at least one account, **Use suggestions** appears beside **Not linked**. Select it. Tilt fills each row it can and leaves the rest for you. Nothing is linked yet.

![Link custodian accounts dialog with a Not linked list. Joint ...8201 reads New client: Rowan Ellery. Traditional IRA ...8202 reads Add to the client made from Joint ...8201. Roth IRA ...8203 reads New client: Priya Calloway. Each has Change and Clear buttons. Individual ...8204 reads Shares a contact at the custodian with Theo Marchetti, Imogen Achterberg and 4 more. Pick by hand, with a Find a client button.](https://mintcdn.com/tilt/uNVzTB5L2kPYfwau/images/advisor/custodian-link-suggestions.jpg?fit=max\&auto=format\&n=uNVzTB5L2kPYfwau\&q=85\&s=0862ba599f04327c197c5fd99f779da6)

After Use suggestions on a made-up firm: three rows are filled, and Individual ...8204 waits for a pick by hand.

Tilt suggests a client from the account holder's name and from other accounts that have the same contact at the custodian. Read each filled row before you link.

| Line on the row | What linking does |
| - | - |
| **New client:** and a name | Makes a client with that name and an account under it. |
| **Add to** and a client | Adds an account under a client you already have. |
| **Add to the client made from** and an account | Adds an account under the client that the other row makes. |
| **Link to** and a client and account | Links to an account that is already in Tilt. This line appears only when you pick the account yourself. |

A row that reads **Shares a contact at the custodian with** some names, then **Pick by hand.**, stays empty. Its contact belongs to accounts under more than one name, such as two spouses or a person and a trust, so you decide which client it goes to.

## 3. Pick a client yourself

Select **Find a client** on an empty row, or **Change** on a filled one. **Clear** empties a row.

![Link Roth IRA ...8203 view with Account holder: PRIYA CALLOWAY. Under Suggested: New client: Priya Calloway, Account name: Roth IRA ...8203. Under Or pick by hand: New client, Add to an existing client, and Link to an account already in Tilt, then a Back button.](https://mintcdn.com/tilt/uNVzTB5L2kPYfwau/images/advisor/custodian-link-pick-view.jpg?fit=max\&auto=format\&n=uNVzTB5L2kPYfwau\&q=85\&s=1d776298c4214ba7490e2e6b125a64c3)

One account's choices: Tilt's suggestion, then the three ways to pick by hand.

Select the suggestion to take it as it is. For an account that shares a contact, **Shares a contact at the custodian** takes the place of **Suggested** and lists the clients that already have an account with that contact.

To choose something else, pick one of the three ways under **Or pick by hand**:

| Choice | What you enter | Result |
| - | - | - |
| **New client** | **Client name** and **Account name**. Tilt fills the name from the account holder and tidies a name the custodian sends in capitals, so check it. Leave **External ID** blank and Tilt makes one. Then select **Use this client**. | A new client with one account. |
| **Add to an existing client** | Search for the client, set the **Account name**, and select **Use this client**. | A new account under that client. |
| **Link to an account already in Tilt** | Search for the account and select it. Tilt lists accounts that have no linked brokerage account. | The existing account, now linked. |

Each pick returns you to the list. A search result can carry a note:

| Note under the result | What linking does |
| - | - |
| **Prospect: becomes a client when linked** | Converts the prospect to a client, so monitoring and trading cover the account. |
| **Has holdings in Tilt: linking replaces them with the custodian's** | Replaces the holdings you entered or uploaded for that account with the custodian's. |

Tilt holds your picks only while the dialog is open. Closing it before you link drops them.

## 4. Link the accounts

Select the **Link** button, which names how many accounts you picked. Tilt links them one at a time, and each account moves to **Linked** as it is saved. If Tilt refuses one account, the others stay linked and the refused row says why.

For each linked account, Tilt:

* copies the holdings and cash it already has for the custodian account to the client's account. If none are ready, they arrive with the next sync. For a Schwab files connection, that is the next business day's files.
* takes the custodian's tax type, unless you chose one for the account yourself.
* records the link, with any client and account it made, in **History**. See [what History covers](https://docs.tilt.now/advisor/history-coverage.md).

Tilt then checks the firm's accounts again, so the tags on **Clients** reflect the holdings the links brought.

## Set up the linked accounts

A linked account is monitored and reviewed like any other account, so it needs the same setup:

1. [Assign a model](https://docs.tilt.now/advisor/build-model-portfolio.md#5-assign-the-model-to-accounts) to each account you want Tilt to manage.
2. [Set the firm's monitoring values](https://docs.tilt.now/advisor/monitoring-policies.md). Accounts use built-in drift thresholds until you set your own. The cash band is checked only after you set a **Cash band watch** for the firm, a model, or the account. If the **Monitoring** dialog shows **Monitoring is off for the firm**, the [daily check](https://docs.tilt.now/advisor/monitoring-explained.md#when-the-daily-check-runs) doesn't run for your firm until Tilt turns monitoring on.
3. Review the accounts that a check finds over a limit on **Trading**, under **To review**. See [Approve and send trades from Trading](https://docs.tilt.now/advisor/approve-trades-from-trading.md).

## Trade an account an outside manager runs

A custodian can report that a manager outside your firm runs an account. Tilt shows that account's holdings but proposes and sends no trades for it. On **Clients** the account carries a **Locked** tag, and the **Trading** section of its **Setup** tab reads **Monitor only**.

If your firm trades the account itself:

1. Open the account and go to **Setup**, then **Trading**.
2. Select **Mark as traded by the firm**.
3. Under **Why does the firm trade this account?**, enter the reason.
4. Select **Mark as traded by the firm**.

![Mark as traded by the firm? dialog. It explains that the custodian reports a manager outside the firm runs this account, that once the firm trades it Tilt treats its holdings as tradable and can propose and send trades, that later custodian reads don't change this, and that the account's attention list updates after the next drift run. Below are a Why does the firm trade this account? field and Cancel and Mark as traded by the firm buttons.](https://mintcdn.com/tilt/uNVzTB5L2kPYfwau/images/advisor/custodian-link-mark-traded.jpg?fit=max\&auto=format\&n=uNVzTB5L2kPYfwau\&q=85\&s=c6b19dcfc172f141dbf06f0fb01d7503)

Tilt asks for a reason before the firm takes over trading of an account.

The section then reads **Traded by the firm**, with who changed it, when, and the reason. Tilt treats the account's holdings as tradable from then on, and later reads from the custodian don't undo your choice. Saving starts a check of the firm's accounts, and the **Locked** tag clears once that check has looked at the account. The tag stays if something else still blocks trading in the account, such as a custodian connection that stopped working.

To hand the account back, select **Follow the custodian** and enter a reason. While the custodian still reports an outside manager, Tilt stops proposing trades for the account again.

The **Trading** section appears only on a linked account that the custodian reports this way, or that your firm has marked. Viewers see **Only owners and editors can change this.** Tilt Agent can prepare either change on a card for you to apply.

## Unlink an account

On **Clients**, select **Link custodian accounts**. Under **Linked**, select **Unlink…** on the account's row, then **Unlink** in the confirmation.

![Unlink Roth IRA ...8203? confirmation. Priya Calloway keeps the holdings Tilt last copied, but they stop updating, and Tilt can't trade this account for them until it's linked again. If you link it to another client, it can trade for them after Schwab's next morning files. To remove the copied holdings, delete the account: press Delete account in the client's actions menu. Buttons: Cancel and Unlink.](https://mintcdn.com/tilt/uNVzTB5L2kPYfwau/images/advisor/custodian-link-unlink.jpg?fit=max\&auto=format\&n=uNVzTB5L2kPYfwau\&q=85\&s=0042716c506687450075618a5e8e1b2f)

The confirmation says what the client keeps and what stops.

After you unlink:

* the client and the account stay in Tilt, with the holdings Tilt last copied. The holdings stop updating.
* Tilt can't trade the account for that client until you link it again.
* the custodian account returns to **Not linked**, ready to link to the same client or another one. On a Schwab files connection, an account you link to a different client can trade for them after the next morning's files.

To remove the copied holdings, open the account, open the **…** menu in its header, and select **Delete account**.

Tilt refuses to unlink an account that has trades it hasn't finished: an approved trade not yet sent, a [trade file](https://docs.tilt.now/advisor/trade-by-file-at-schwab.md) not yet reported or matched, or an order still open. Unlink the account once those trades finish or are canceled.


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