> For the complete documentation index, see [llms.txt](https://docs.spicychat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spicychat.ai/product-guides/premium-features/memory.md).

# Memory

How characters remember the important details of your chats

> We've rebuilt the memory system. This page describes the new version. Memory is available to **True Supporter** and **I'm All In** subscribers, in both new and existing chats.

#### Overview

Every character can only "see" a certain amount of your conversation at once. That's its **context memory**. Once a chat gets longer than that, the oldest messages fall out of view.

**Memory** fills that gap. As your chat grows, the system saves the important details as short **memories**. When the character replies, the most relevant memories are added to what it can see, so it keeps track of names, relationships, plot points and details from much earlier in the story.

#### 🧩 How it Works

* **Early on, nothing is saved.** While your whole conversation still fits in what the character can see, it doesn't need memories yet. The Memory Manager shows **Not creating memories yet**.
* **Memories start once the chat outgrows the context.** From then on, about every **15 back-and-forths**, the system:
  * adds new memories for new details,
  * **updates** memories that changed (for example, if you moved to a new city), and
  * **removes** memories that no longer apply.
* **One fact per memory.** Each memory is a single, short fact, and it's tagged with **who it's about**, such as the character, your persona, or another character in the story. This helps characters keep multiple people's details separate.
* **Only the most relevant memories are used.** For each reply, the character gets the memories that matter most for the current moment of the conversation, not all of them at once.
* **Your memories are always kept.** Memories you **pin** and memories you **add yourself** are never removed by the automatic updates.

<figure><img src="https://3060264960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZHNBN3T5KDxoXWSU7L3d%2Fuploads%2Fary5vaVMCvQN9MdFTOcf%2Fmem-1-how-it-works.png?alt=media&amp;token=9e99ac8d-87dd-46b1-9bba-cdb13b701f27" alt=""><figcaption></figcaption></figure>

> Until the system starts creating memories in a chat, only **pinned** memories are sent to the character. If you want the character to know something important early on, add it and pin it.

#### 💾 Save to Memories

You can turn any message into memories yourself:

1. Open the **⋮** menu on a message.
2. Select **Save to memories**.

<figure><img src="https://3060264960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZHNBN3T5KDxoXWSU7L3d%2Fuploads%2Fbf3y4wCzcuHzVeAyDMxG%2Fmem-2-save-to-memories-menu.png?alt=media&amp;token=2f6bc57a-c7c8-45d9-b64b-e02a77ad6890" alt=""><figcaption></figcaption></figure>

3. The system finds the facts in that message and lists them.
4. Choose what the character should remember:
   * Untick anything you don't want saved, or use **Clear all**.
   * Select the ✏️ icon on a fact to reword it, then select **Done**.
5. Select **Save memories**.

<figure><img src="https://3060264960-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZHNBN3T5KDxoXWSU7L3d%2Fuploads%2FN2hahBFF1YKY5058rDqP%2Fmem-3-save-dialog.png?alt=media&amp;token=553435a2-7562-493c-84f6-dd3d2ffdb078" alt=""><figcaption></figcaption></figure>

The new memories appear in the [Memory Manager](https://docs.spicychat.ai/product-guides/premium-features/memory-manager).

#### 🔁 Turning Memory Off for a Chat

Use the **Memory** toggle at the top of the Memory Manager. When it's off, no new memories are created in that chat. You can turn it back on at any time.

#### 💡 Tips for Better Results

✅ **Pin what matters most.** Pinned memories are always kept and are sent to the character even before automatic memories start.

✅ **Keep your own memories short.** One clear fact per memory works best (up to 250 characters).

✅ **Rate automatic memories.** Use 👍 or 👎 on automatic memories to tell us whether they're accurate.

✅ **Fix mistakes early.** If a memory is wrong, edit or delete it so the character doesn't keep using it.

#### ❓FAQ

<details>

<summary>Does the new memory system work in my existing chats?</summary>

Yes. It works in both new and existing chats.

</details>

<details>

<summary>Why don't I see any memories in my new chat?</summary>

That's expected. While the character can still see your whole conversation, it doesn't need memories, so the Memory Manager shows **Not creating memories yet**. Memories start once the chat grows past what the character can hold. You can still add, save and pin memories yourself at any time.

</details>

<details>

<summary>Will the character forget something if a memory is removed?</summary>

The system only removes automatic memories that are out of date, for example when something in the story changed. Memories you pinned or added yourself are never removed automatically.

</details>

<details>

<summary>What does "Not sent to the bot yet" mean?</summary>

Memories in this section are saved, but the character isn't using them yet. Before automatic memories start in a chat, only pinned memories are sent. Pin a memory if you want the character to use it straight away.

</details>

<details>

<summary>What are the tags on each memory?</summary>

They show who the memory is about, such as the character or your persona. You can use the **Tags** filter in the Memory Manager to show only memories about one person.

</details>

<details>

<summary>Can I stop memories being created in a chat?</summary>

Yes. Turn off the **Memory** toggle in the Memory Manager. No new memories will be created in that chat until you turn it back on.

</details>


---

# 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.spicychat.ai/product-guides/premium-features/memory.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.
