For the complete documentation index, see llms.txt. This page is also available as Markdown.

Pins & Locks

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

Available on PREMIUM and ULTIMATE. Lorebooks are included for all subscribers on these plans. On FREE, your companions use the Memory System.

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.

Mira Vale entry with active pin and lock controls, at the top of the saved entry
The same entry can be pinned, locked, both, or neither.

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. 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.

Last updated

Was this helpful?