> ## 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.

# Keep client documents and facts in Notes

> Save an IPS or meeting notes from chat or a file to a client's Notes, open the version Tilt Agent cited, and keep facts in fields. Notes and Memory change no account settings.

Every household, client, and account has a **Notes** tab, and the **Firm** page has one for the whole firm. **Pages** hold documents such as an IPS, meeting notes, or a memo. **Fields** hold single facts, such as a review tier or a client's tags. Tilt Agent reads a record's Notes before it works on that record, including the pages and fields the record inherits from its client, household, and firm.

Any member of your firm can read Notes, and owners and editors can change them. The examples follow the made-up Okafor household and its Okafor Joint account.

## Save a document from chat

After you draft a document with Tilt Agent, such as an IPS, ask it to save the draft to the record it belongs to: **"Save it to the Okafor household's Notes."** Tilt Agent saves the draft as a page on that record and links to the page in its reply.

![Chat beside the Okafor household's Notes. The message Save it to the Okafor household's Notes gets a reply from Tilt Agent: it saved the IPS addendum as a separate page and left the existing IPS and account settings unchanged. The household's Pages list, with Import file and New page buttons, includes the addendum at version 1, saved by Tilt Agent.](https://mintcdn.com/tilt/sgvtmdt0AvWIfpmT/images/advisor/notes-save-from-chat.png?fit=max\&auto=format\&n=sgvtmdt0AvWIfpmT\&q=85\&s=c94c4917bd05f8aa9e011650202b2705)

Tilt Agent saves a drafted IPS addendum as a new page on the Okafor household. The household's Notes list it as version 1.

Tilt Agent saves a new meeting or document as a page of its own, and changes an existing page, such as the IPS, only when you ask it to.

To write a page yourself, open the record's **Notes**, select **New page**, enter a title and text, and select **Save**. To change a page, open it and select **Edit**. Each save adds a version, and the earlier versions stay with the page.

## Import a file

1. Open the record's **Notes** and select **Import file**.
2. Select **Choose file** and pick one or more files. You can also drop files anywhere on the tab.
3. Select **Open page** once the import finishes.

Notes imports a PDF, a spreadsheet (.xlsx), or a CSV, text, Markdown, or JSON file, up to 15 MB. Tilt turns each file into a page on the record and keeps the file as the page's source. The line under the page's title shows **Source** and the file's name; select the name to download the original.

If the file states a value that one of the record's fields holds, such as an advisory fee, Tilt Agent sets that value and marks it **Unconfirmed**. Your Main chat shows Tilt's report on each import, including the values it set.

Importing a file with the same name as an earlier import adds a new version to the page that import made. The new version holds the file's text, and edits saved since the last import stay in the page's earlier versions.

Tilt reads scanned PDFs too. If it can't read any text in a file, such as a faint or blurred scan, the import makes no page, and your Main chat says the file has no readable text. Import a clearer copy.

## Open the version Tilt Agent cited

An answer Tilt Agent draws from a page links to the page and section it used. Select the link to open the page at the version Tilt Agent read, with that section marked **Cited section**.

If someone has saved a newer version since, the page says which version you're reading, with a link to **Open the current version**. Read the current version before you act on the answer.

![The Okafor IPS at Version 2 of 3, saved Nov 12, 2026 by Dana Whitfield. An alert reads You're reading version 2 and The page is at version 3, with an Open the current version link and a Restore version 2 button. Further down, the Restrictions section is highlighted under the label Cited section.](https://mintcdn.com/tilt/sgvtmdt0AvWIfpmT/images/advisor/notes-cited-version.png?fit=max\&auto=format\&n=sgvtmdt0AvWIfpmT\&q=85\&s=29698333a5250db1b46fff6d7f8a40d5)

A citation of the Okafor IPS opens version 2 at its Restrictions section. The page is now at version 3.

**Versions** lists a page's versions, newest first, with when each was saved, who saved it, and the file it came from. Select a version to read it. To bring one back, open it and select **Restore version**. Tilt saves that text as the newest version, and the versions in between stay in the list.

## Keep facts in fields

A field holds one value for each record: text, a number, an amount, a date, a choice from a list, a member of your firm, or tags. Every record has **Tags**, for labels such as onboarding. Your firm adds its own fields, such as **Review tier** or **Next review**, in the **Firm** page's **Setup**, or by asking Tilt Agent. A new field appears on every record of those kinds across your firm. [Manage your firm's fields](https://docs.tilt.now/advisor/manage-firm-fields.md) covers adding, renaming, and deleting them.

To change a value, select **Edit**, or **Set** on an empty field, and then **Save**. Tilt saves the value at once, and the record's **History** shows the change. Fields without a value fold under a line that counts them, such as **Show 2 empty fields**.

## Confirm values Tilt Agent set

**Unconfirmed** marks a value no person has confirmed. Tilt Agent leaves a value unconfirmed when it reads the value from a page or an imported file, and values an automation sets stay unconfirmed too. The line under the value says who set it and, for a value from a page, links to the version it came from.

![Fields on the Okafor household. Advisory fee (bps) shows 85, marked Unconfirmed and set by Tilt Agent from Annual review, November 2026, version 1, with Confirm and Edit buttons. Next review shows Mar 15, 2027 and Review tier shows A, each confirmed by Dana Whitfield. Show 1 empty field sits below.](https://mintcdn.com/tilt/sgvtmdt0AvWIfpmT/images/advisor/notes-fields-household.png?fit=max\&auto=format\&n=sgvtmdt0AvWIfpmT\&q=85\&s=ead913ae0fb4f1b50c51c36108f3380f)

On the Okafor household, the advisory fee Tilt Agent set from the imported annual review waits for a person to confirm it.

Check the value against its source, then select **Confirm**. With several unconfirmed values on the record, **Confirm all** confirms each one. A value you save yourself with **Edit** counts as confirmed.

If you tell Tilt Agent a value in chat, it can save the value as confirmed in that chat. The field still shows **Unconfirmed**, with **Confirmed in a Tilt Agent chat, which rules don't count**. Tilt Agent answers from the value, and rules wait until you confirm it in Tilt.

## Read what an account inherits

An account reads each field from the nearest record with a value: the account, then its client, its household, and the firm. A value from another record says **From** and names that record. The account's **Pages** also list the pages it inherits, under **Inherited from** and the record's name.

![Fields on Okafor Joint. Tags shows onboarding, confirmed by Dana Whitfield. Advisory fee (bps) shows 85, marked Unconfirmed, from Okafor household, set by Tilt Agent from Annual review, November 2026, version 1. Review tier shows A, from Okafor household, confirmed by Dana Whitfield. Each field has an Edit button.](https://mintcdn.com/tilt/sgvtmdt0AvWIfpmT/images/advisor/notes-fields-account.png?fit=max\&auto=format\&n=sgvtmdt0AvWIfpmT\&q=85\&s=fdc189d544be91a99cdb01a032092229)

Okafor Joint keeps its own Tags. Its advisory fee and review tier come from the Okafor household.

Saving a value on the account sets the account's own value in place of the inherited one. To go back to the inherited value, clear the account's value. In a choice list, the last option reads **Clear Okafor Joint's value**.

Confirm a value on the record that holds it. On Okafor Joint, the inherited advisory fee has no **Confirm** button: select **Okafor household** after **From**, and confirm the value in the household's Notes.

## Find records by tag

Tags show beside each record on **Clients** and a model's **Accounts**, and both lists filter to one tag. [Find clients and accounts by tag](https://docs.tilt.now/advisor/find-records-by-tag.md) covers the filter and why each row matched.

## See where a record was discussed

**Discussed in**, at the foot of a record's Notes, lists the visits that discussed the record, newest first. A visit is the turns one chat sent about the record, from any of its tabs, with no more than 30 minutes between one turn and the next. A turn about another record starts a visit on that record's list. A household's list also shows its clients' and accounts' visits, a client's list shows its accounts' visits, and the firm's list shows every record's.

Each row leads with a one-line takeaway of what the visit found, decided or proposed. Below it, the row names where the visit started, the chat, when, and how many turns it held. Select a row to open the chat at the visit's first turn. In the Mac app, the chat opens in the window beside the page.

![Discussed in · 2 at the foot of the Okafor household's Notes. The first row reads Proposed a \$300K cash reserve by June 1, 2027, pending review; no settings or trades changed yet, with Okafor Joint · Notes · Main chat · 7 minutes ago · 3 turns below it. The second row reads Before the next rebalance, focus on shared equity exposure, taxable lot selection, and the 529's separate implementation, with Notes · Main chat · 14 minutes ago below it.](https://mintcdn.com/tilt/tVSgv2kWEjxB7-Sn/images/advisor/notes-discussed-in.png?fit=max\&auto=format\&n=tVSgv2kWEjxB7-Sn\&q=85\&s=9dd32d966bb63a3fa2d0cfb1ffce569a)

The Okafor household's Discussed in. A three-turn visit on Okafor Joint proposed a cash reserve; a visit on the household's own Notes left a note for the next rebalance.

Tilt writes the takeaway after each answer. With that chat open beside the list, the row switches to it without a reload. Until then, a row shows the visit's first question, and so does a visit that only greeted, asked a clarifying question, or looked up where the record was discussed. A visit in a chat you can't open shows only when it happened.

Pages whose current version links to the record appear in the same list, with that version's number. Remove the link in a new version, and the page leaves the list. The count beside **Discussed in** includes visits and pages. Select **Show older chats** to read further back.

An open page has its own **Discussed in** for the visits that sent a turn from that page. To ask instead, try **"Where have we discussed the Okafor household?"** Tilt Agent answers with the same visits and their takeaways.

## Notes, settings, and Memory

A page or field changes nothing Tilt enforces until someone applies a rule or setting. Tilt enforces an account's **Setup** when it optimizes, your monitoring policies when it checks accounts, and your trade release rules when someone sends a proposal.

A page records what the client wants. The Okafor IPS rules out tobacco producers, and that line excludes no ticker from any account. To apply it, change the account's settings: add the tickers to **No-hold tickers** in the account's **Setup**, or ask Tilt Agent to prepare that change as a [change review](https://docs.tilt.now/tilt-agent/change-reviews.md).

A field changes what Tilt does only through a rule that reads it, such as a trade release rule for accounts tagged onboarding. Conditions in **Setup**, monitoring policies, and [trade release rules](https://docs.tilt.now/advisor/trade-release-conditions.md) can read fields. A rule reads only values a person confirmed, in Notes or by applying a change review. For **Tags**, a rule adds up the levels: an account carries its own tags and those of its client, household, and firm. A tag nobody confirmed doesn't count for the rule.

* Applying a rule that reads a field also confirms that field's unconfirmed values. The change review or **Queued changes** lists those values, so check them before you apply.
* Once a rule reads a field, a value someone saves or confirms in Notes counts for that rule.
* Tilt Agent changes a field that a rule reads only through a change review.

Target weights are settings. Select **Save portfolio** in an account's **Setup**, or apply a model's allocation from **Queued changes**, and Tilt uses the new targets in the next optimization and in drift monitoring. The 70% equity, 25% fixed income, and 5% cash allocation in the Okafor IPS sets no targets until someone saves those weights on the model or the account. Saved targets still trade nothing until someone sends a proposal.

**Settings > Memory** holds context Tilt Agent keeps for you alone across your chats, such as how you like answers written. Memory doesn't show Notes or fields, and it changes no settings. When you ask Tilt Agent to remember something about a client, household, or account, it saves that to the record's Notes, where your firm reads it too. That applies nothing either; change the account's settings to apply a constraint.


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