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

# Agent memory and workspace memory

> Manage Agent memory in Cometly: review, edit, promote and delete what the Agent remembers about you, your space and your account.

The Agent (Cometly's AI assistant) remembers short facts between chats and uses them to personalize its answers. The **Agent memory** page is where you manage Agent memory in Cometly: you see what it has remembered about you, the current space (the workspace you are in) and your account, and you correct or delete it.

This matters because the Agent answers questions about your ad performance with these facts in mind. When a goal, a reporting preference or a campaign detail is remembered correctly, you do not have to repeat it in every chat. When a memory is wrong or out of date, this is where you fix it.

## Where to find it

Click **Settings** at the bottom of the left sidebar, then either:

* **Agent memory** under **You**, which opens the **Your memory** tab.
* **Workspace memory** under **Workspace**, which opens the **Space** tab.

Both open the same page, titled **Agent memory**. The tabs at the top switch between the scopes.

## Who can use it

Every user sees both menu items, can read all three memory tabs, and can manage their own memories.

Only the account **Owner** can:

* Edit, delete or clear **Space** and **Team** memories, and turn those two scopes on or off.
* See the **Pending** tab and promote or dismiss the memories on it.
* Use the **Seed memories** and **Backfill from chats** buttons.

Account Administrators do not get these. For anyone but the Owner, the switch on the **Space** and **Team** tabs is disabled, and an attempt to edit, delete or clear there fails with **Could not save memory.**, **Could not delete memory.** or **Could not clear memories.**

## What a memory is

A memory is one short fact, up to 500 characters, for example a reporting preference or a goal. In the list, each memory shows:

* A category: **Fact**, **Objective**, **Campaign**, **Integration** or **Preference**.
* **Importance**, from 1 to 10.
* **Time-bound**, when the memory is set to expire.
* Where it came from when it was not saved automatically from a chat (for example **via Ask AI**, **via seed** or **via promoted**), the date it was created, and how many times the Agent has used it.

Memories are not the same as [custom instructions](https://docs.cometly.com/guides/agent/custom-instructions.md), which are applied to every conversation.

## Scopes and tabs

| Tab | What it holds | Who sees these memories |
| - | - | - |
| **Your memory** | Facts about you and how you work | Only you |
| **Space** | Facts about the space you are in | Everyone in this space |
| **Team** | Facts about the whole account | Everyone on your account |
| **Pending** (Owner only) | Teammates' memories suggested for sharing | The account Owner |

The card at the top of each scope tab has:

* **A count** of how many memories are stored, out of the limit for that scope. When a scope goes over its limit, Cometly removes memories automatically, starting with those that are least important, oldest and least used.
* **A switch** labelled **Enabled** or **Disabled**. When a scope is disabled, the Agent stops using its memories in chats. The memories stay stored. Disabling **Your memory** also stops the Agent from saving new memories from your chats. Each scope is switched independently.
* **Clear all**, shown when the scope has memories.

The list shows the 50 most recently updated memories of the scope.

## How memories are added

The page has no button for writing a memory by hand. Memories arrive in these ways:

* **From your chats.** After a chat, the Agent saves lasting facts it learned to **Your memory**.
* **By asking.** Tell the Agent in a chat to remember something, or to forget it. These are saved to **Your memory** too.
* **Seed memories** (Owner). Creates **Team** and **Space** memories from settings Cometly already has: the account name, its default timezone and currency, your custom instructions, and each space's name, timezone, currency and connected integrations. You see **Seeding queued. Memories will appear shortly.** Running it again does not create duplicates.
* **Backfill from chats** (Owner). Goes through the account's chats from the last 90 days and saves memories from them, each to the memory of the person who owns the chat. You see **Backfill queued. This may take a few minutes.**
* **Promotion** (Owner). See [Promote pending memories](#promote-pending-memories).

Chats only ever add to the personal memory of the person chatting. A fact reaches **Space** or **Team** memory only when the Owner seeds or promotes it.

In a chat, a small badge under the latest reply shows when memories were used or saved (for example **Used 2 · Saved 1**). Click it to see them, with a **Manage memories** link to this page.

## Edit a memory

**1. Open the memory**

Hover over the memory and click the pencil icon. The **Edit memory** dialog opens.

**2. Change it**

Edit the **Memory** text (up to 500 characters), the **Category** and the **Importance** (1 to 10). A higher importance makes the Agent more likely to use the memory and keeps it longer when the scope is full.

Tick **Time-bound (auto-expires after 90 days)** for a fact that will stop being true.

**3. Save**

Click **Save**. You see **Memory updated.**

## Delete memories

* **One memory**: hover over it, click the trash icon and confirm. You see **Memory deleted.**
* **A whole scope**: click **Clear all** and confirm. Every memory in that scope is deleted, not only the ones listed, and you see how many were cleared.

Both confirmations say deleted memories can be recovered for 30 days. After that they are removed for good. The page has no restore button, so [contact support](https://docs.cometly.com/support/contact.md) if you need a deleted memory back.

## Promote pending memories

Only the account Owner sees the **Pending** tab. A number next to its name shows how many memories are waiting.

When the Agent saves a memory for a teammate that looks useful to everyone, it lists it here under **Pending promotion**, with the teammate's name and the chat it came from. This is the only place where the Owner sees another user's personal memories. For each one, choose:

* **Promote to team**: the fact becomes a **Team** memory, and the teammate's personal copy is retired.
* **Promote to space**: the fact becomes a **Space** memory in the space the memory came from, which may not be the space you are in. If the memory has no space, this fails with **Could not promote memory.** Use **Promote to team** instead.
* **Dismiss**: the memory stays private to the teammate and leaves the list.

## Frequently asked questions

### Does the Cometly Agent use every memory in every chat?

No. For each reply, the Agent picks only the few memories most relevant to your question, favoring ones with a higher importance and ones it has used recently. Memories in a scope that is switched to **Disabled** are not used at all.

### What is the difference between Agent memory and custom instructions?

Custom instructions are text you write yourself, and they are applied to every conversation in your team. Memories are short facts the Agent saves from chats, and it uses one only when it is relevant to what you ask. Use custom instructions for how your business works, and let memory hold the details that come up along the way.

### Can my teammates see what the Agent remembers about me?

No. Memories on the **Your memory** tab are visible only to you. The one exception is the account Owner's **Pending** tab, which lists a personal memory the Agent suggests sharing. It becomes visible to others only if the Owner promotes it to **Space** or **Team** memory.

## Next steps

* [Use the Agent](https://docs.cometly.com/guides/agent/overview.md)
* [Best practices for custom instructions](https://docs.cometly.com/guides/agent/custom-instructions.md)
* [Account roles and permissions](https://docs.cometly.com/guides/account/team-roles.md)

Still have questions or need a hand? We're happy to help. Reach our team at [support@cometly.com](mailto:support@cometly.com).


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