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

# Stella memory

> Short facts Stella saves while you chat and reads at the start of every new chat.

## Overview

Stella, your AI teammate, can remember short facts so you don't have to repeat them: who you sell to, how you like emails written, a decision your team made. Each memory is one fact. Every new chat starts with the workspace's memories plus your own private ones.

Memories are notes, and [rules](https://docs.custral.com/ai/rules-and-skills.md) are rules. When a memory and a workspace rule disagree, the rule wins.

![Settings → AI and automations → Rules & Skills → Memory.](https://docs.custral.com/images/screens/ai/memory-light.png)

Settings → AI and automations → Rules & Skills → Memory.

## How it works

* **Stella saves a fact when it will still be true next week**, or when you ask it to remember something ("remember that our ICP is Series A SaaS"). It doesn't save passwords, keys or other secrets, one-off details of a chat, or facts already stored on a record.
* **In Auto mode** the fact is saved straight away and the chat shows a **Saved to memory** chip with **View** (opens the Memory tab) and **Undo** (removes it). A fact that was already saved shows **Already in memory**, with no Undo.
* **In Ask first mode** the approval card shows the fact before anything is saved. See [Permissions](https://docs.custral.com/ai/permissions.md).
* **Who sees it.** A memory is **Workspace** (read into everyone's chats) or **Only me** (read into your chats only). Stella saves facts about the business to the workspace, and your own preferences, like how you write, as Only me.
* **Chats read memory when they start.** A chat that's already open doesn't pick up a memory saved or changed after it began.

| Limit | Value |
| - | - |
| One memory | Up to 500 characters |
| Memories per workspace | 300 |
| Read into each new chat | The newest 40, up to 6,000 characters in all |

## Using it

**1. Tell Stella**

In any chat, say what to remember, for example *"Remember that Hooli's renewals go through Gavin Belson."*

**2. Check the chip**

If it saved the wrong thing, choose **Undo** on the **Saved to memory** chip.

**3. Review your memories**

Open **Settings → AI and automations → Rules & Skills → Memory**. Each row shows the memory, **Who sees it**, and its **Source**: *Learned in chat* with the date, or *Added by* and the person's name.

**4. Add, edit or clear**

**Add memory** asks *What should Stella remember?* and **Who sees it** (Workspace or Only me). Edit or delete a row from its menu. **Clear all** deletes every memory you're allowed to delete.

### Who can change what

| Action | Who |
| - | - |
| Add a memory | Any member |
| Edit or delete a memory | The person who saved it. An admin can also edit or delete any **Workspace** memory. |
| Move a memory between Workspace and Only me | Only the person who saved it |
| See an **Only me** memory | Only the person who saved it, admins included |
| Turn **Let Stella save memories** on or off | Admins |

**Clear all** deletes, for an admin, every Workspace memory plus their own private ones, and for a member, only the memories they saved.

### Turning memory off

**Let Stella save memories** sits at the top of the Memory tab. When an admin turns it off, Stella saves nothing new and starts chats without any memories. The saved memories stay in the list and are read again once it's back on.

## Troubleshooting

| Symptom | Likely cause | What to check |
| - | - | - |
| Stella says memory is switched off for this workspace | An admin turned off **Let Stella save memories** | Ask an admin to turn it on in the Memory tab. |
| Stella says the workspace's memory is full | The workspace already has 300 memories | Delete old ones on the Memory tab, then ask again. |
| Stella says the memory was empty or too long | One memory holds up to 500 characters | Ask Stella to save one shorter fact. |
| Edit and Delete are greyed out on a row | "Only the person who saved it, or a workspace admin, can change a shared memory." | Ask the person who saved it, or an admin. |
| Editing a memory shows no **Who sees it** choice | Only the person who saved a memory can change who sees it | Ask the person who saved it. |
| The memory switch is greyed out | "Only workspace admins can turn Stella's memory on or off." | Ask an admin. |
| Stella didn't use a memory | Chats read memories when they start, and only the newest 40 (up to 6,000 characters). A rule that says otherwise wins. | Start a new chat. Check the **Rules** tab for a rule that conflicts. |

## Related

> [card] [Rules & Skills](https://docs.custral.com/ai/rules-and-skills.md)
>
> Standing guidance Stella must follow, and reusable `/commands`.

> [card] [The Stella chat](https://docs.custral.com/ai/stella-chat.md)
>
> The composer, chat history and commands.

> [card] [Permissions](https://docs.custral.com/ai/permissions.md)
>
> Why Ask first shows a memory before it's saved.

> [card] [AI defaults](https://docs.custral.com/ai/ai-defaults.md)
>
> Business knowledge every AI feature reads.


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