> For the complete documentation index, see [llms.txt](https://wiki.secrets.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.secrets.ai/lorebooks/pins-and-locks.md).

# Pins & Locks

PREMIUM and ULTIMATE feature. Choose what stays consistently available and what your companion is allowed to change.

{% hint style="info" %}
**Available on PREMIUM and ULTIMATE.** Lorebooks are included for all subscribers on these [plans](/get-started/subscription-tiers-and-limits.md). On FREE, your companions use the [Memory System](/get-started/memory-system.md).
{% endhint %}

**Pin** and **Lock** solve different problems. Pinning keeps an entry's information available throughout the conversation. Locking prevents the companion from changing the entry while still allowing it to be read.

Use the pin and padlock controls on saved entries in **Cast**, **World**, **Relationship**, and **Facts**. You can pin an entry from its list row or from the open entry. Save a new entry before looking for these controls.

<figure><img src="https://3286776735-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9ACKOAU4nFWSXPeE2B4s%2Fuploads%2Fgit-blob-b800a4b2a345b82cea977c8b1bd16a2977e67f8e%2Fcast.png?alt=media" alt="Mira Vale entry with active pin and lock controls, at the top of the saved entry"><figcaption><p>The same entry can be pinned, locked, both, or neither.</p></figcaption></figure>

## Choose the control you need

| Setting               | What it does                                                   | Good use                                                                        |
| --------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| **Pinned**            | Keeps the entry in the companion's ongoing context             | A short core identity or relationship detail that matters throughout the story. |
| **Locked**            | Allows the companion to read it but prevents companion changes | An established setting rule you want to control yourself.                       |
| **Pinned and locked** | Combines both behaviors                                        | A concise, settled rule or core identity you want consistently available.       |
| **Neither**           | Keeps an ordinary editable entry in the book                   | Background details that matter only in some conversations.                      |

Locking is not a visibility setting. A locked entry is still readable. Pinning does not lock an entry, and locking does not pin it.

## Pin an entry

1. Open the correct book and entry.
2. Save any text edits first.
3. Select the **pin icon**.
4. Check that it is highlighted and the entry appears in its section's pinned group.

Select the icon again to unpin. Unpinning keeps the entry in the book; it does not delete its contents.

### What deserves a pin?

Choose information that matters in most conversations using this book. For the Asterfall example, that might be a brief identity for Mira and a compact account of the friendship with Rowan.

Avoid pinning every place, preference, and past event. A pin is useful when the information deserves ongoing attention. Ordinary entries can still be used when relevant.

## When there is not enough pin space

The editor may show **Not enough pin space** or indicate that there is no room for another entry.

1. Check the **Pinned** amount on Overview.
2. Unpin a less important entry, or shorten an entry that uses a lot of space.
3. Keep only the essential details in the entry you want to pin.
4. Try the pin again.

Each area on Overview has its own displayed space. A roomy Total or a short Premise does not necessarily mean there is room for another pin. Follow the current screen's amounts; there is no fixed number of entries that always fits.

### If existing pins no longer fit

If your available pin space becomes smaller, for example after changing subscription tiers, some entries can be **automatically unpinned** to keep the remaining pins within the available space. Their contents stay in the book, and any locks remain in place.

Check the current pin icons and the **Pinned** amount. Shorten lengthy entries or unpin less important ones before pinning your essentials again. You do not need to recreate an entry that lost its pin.

Pins and locks also work in [**Universe Books**](/lorebooks/universe-books.md). A companion book made from a Universe keeps its locks and the pins that fit its available space; entries that do not fit as pins are still copied as ordinary entries.

## Lock an entry

1. Open a saved entry.
2. Save any changes you have made.
3. Select the **padlock icon** and check that it is highlighted.

You can still edit a locked entry yourself and save the correction. Select the padlock again to let the companion propose changes in the future.

If your companion reports being unable to change a locked entry, open it and decide whether to make the correction yourself or unlock it. A lock is useful for stable information but can also leave an outdated fact in place if you never review it.

## Chronicle works differently

Chronicle has no ordinary pin or lock toggles. To keep a lasting detail from a scene available, add that detail to Cast, World, Relationship, or Facts. Keep the event's account in Chronicle.

## Changes apply across the book

Pins and locks belong to the entry in the book. If several chats use that book, the same setting applies to all of them. To maintain different rules in a different storyline, use [a separate book](/lorebooks/managing-books.md).