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

# Update holdings

> Keep your holdings and cash in sync in the app.

Allocait never places a trade for you. When what you hold changes somewhere else, you update it here so your statuses stay accurate.

You enter the share count you hold now, not the change. Allocait works from current share counts. Each change you record is listed in the [action log](https://docs.allocait.app/concepts/action-log.md).

To enter many holdings at once, see [Import holdings](https://docs.allocait.app/guides/import-holdings.md). To update through an agent or code, see [Update with an agent](https://docs.allocait.app/guides/update-with-an-agent.md).

## In the app

**1. Open Positions**

Go to **Positions**.

**2. Add or edit a holding**

Use **Add position** for a new holding, or open an existing one and enter its new total share count. The dialog shows the cost or change, your cash afterward and the resulting allocation before you save.

**3. Save**

Allocait settles the cash difference at the latest quote it has stored for the symbol: a higher count debits your cash, a lower one credits it. If your recorded cash falls short, the dialog offers to deposit the shortfall first (already checked when your cash is \$0). That records a cash deposit, then saves the holding.

To set or adjust your cash balance directly, for example after a deposit or withdrawal that isn't tied to a change in holdings, open the **Position actions** menu at the top right and choose **Deposit or withdraw cash**.

## After a rebalance

Choose **Record trades** on [Plan a rebalance](https://docs.allocait.app/guides/plan-a-rebalance.md). The dialog fills in the new total for each holding the amounts move. Enter what you now hold, untick the holdings you didn't change, and save the rest together. Cash moves at the latest quote Allocait has stored, and Allocait places no orders.

## Options, shorts and Moves

* **Option:** add it by its option symbol, with shares as contracts times 100 and the **Mark** as the premium per share. See [Options](https://docs.allocait.app/concepts/options.md).
* **Short:** turn on **Allow shorts** in **Settings**, then **Portfolios**, and choose **Short** in the holding dialog. See [Shorts](https://docs.allocait.app/concepts/shorts.md).
* **Inverse or leveraged fund:** set **Moves** on the holding. See [Moves](https://docs.allocait.app/concepts/moves.md).

Changing only the Mark or only Moves records no trade and moves no cash.

## Closing a holding

Set the new total to 0, or choose **Remove** from the holding's menu. The Remove dialog adds the holding's value to your cash by default. Clear that option if you entered the holding by mistake. A removal that adds cash is logged in Actions; one that leaves cash alone is not. Removing an expired option adds no cash.

Removing a short with a price covers it: the dialog takes the cost from cash, and Remove is off if your cash falls short of that cost. A short with no price can't be covered, so removing it takes no cash.

## Next steps

> [card] [Import holdings](https://docs.allocait.app/guides/import-holdings.md)
>
> Paste a list or upload a CSV.

> [card] [Action log](https://docs.allocait.app/concepts/action-log.md)
>
> The record of each change you make.

> [card] [Plan a rebalance](https://docs.allocait.app/guides/plan-a-rebalance.md)
>
> See the amounts that close a gap.

> [card] [Check a change](https://docs.allocait.app/guides/check-before-you-trade.md)
>
> Ask which rules a change would affect.


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