Managing Keywords

PREMIUM and ULTIMATE feature. View and edit entry keywords, choose useful phrases, and understand automatic and custom keyword lists.

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

Keywords are short words or phrases associated with an entry. Use them for names, nicknames, places, and distinctive topics you might mention in conversation. They help connect those references with the relevant entry.

You can keep the automatically generated keywords or replace them with a list you choose. You do not need to customize every entry before chatting.

Keywords, description, and Content

These parts of an entry have different jobs:

Part	What belongs here	Lantern Lighthouse example
Title	A clear name for the entry	Lantern Lighthouse
How [companion] finds this	A short description identifying the subject	Lantern Lighthouse, Asterfall coast, map room, silver bell
Content	The actual details to remember	The lighthouse layout and the rule about ringing the silver bell.
Keywords	Individual names, terms, or phrases you might use for this subject	Lantern Lighthouse, map room, silver bell, entered on separate lines.

A keyword does not add a fact to Content. For example, adding silver bell does not explain when someone should ring it; write that rule in Content. Keywords also do not pin or lock an entry, and they do not guarantee that a particular response will mention it.

Open the keyword list

1. Open the correct book and select an entry.

2. If it is a new entry, fill in its text and Save it first.

3. Scroll below Content and select Keywords.

4. Check the entry title at the top of the dialog before editing.

Open Keywords below a saved entry's Content. New, unsaved entries do not show this button yet.

Keywords can be edited on saved Cast, World, Relationship, and Facts entries, and on Chronicle scenes. Chronicle chapters and arcs let you view their keywords but do not let you edit them.

Add, replace, or remove keywords

In the Keywords dialog:

1. Enter one keyword or phrase per line. Press Enter to start another line.

2. Edit a line to replace a keyword, or delete the whole line to remove it.

3. Keep the list at eight keywords or fewer, using the displayed counter.

4. Select the dialog's Save button. After a successful save, the dialog closes.

5. Reopen Keywords if you want to check the saved list.

A phrase such as map room counts as one keyword. Do not put a comma-separated list on one line expecting separate keywords; use separate lines instead. Blank lines and repeated identical lines do not add to the count, and spaces at the beginning or end of a line are removed.

Each line is one keyword. The counter shows how much of the eight-keyword allowance is in use.

The example shown contains:

Lantern Lighthouse
lighthouse
map room
silver bell

Common English singular and plural forms match automatically. For example, map room also covers map rooms, so you only need one form in the list. You do not need to fill all eight slots.

Cancel, the close button, or Escape closes the dialog without saving your keyword edits. While a save is in progress, wait for it to finish.

Choose useful keywords

Choose terms that identify this entry and match how you refer to its subject.

Entry	Useful choices	Why they help
Mira Vale	Mira Vale, lighthouse keeper, brass compass	Her name, role, and a distinctive possession.
Lantern Lighthouse	Lantern Lighthouse, map room, silver bell	The place's name and recognizable features.
Mira and Rowan	Mira and Rowan, North Star, mapmaking promise	The people, a meaningful nickname, and an established agreement.
Rowan's tea preference	Rowan, mint tea, tea preference	The person and the specific topic.
The map room visit	map room, north-coast chart, harbor archive	Specific places and subjects involved in the event.

Use a nickname only if it actually refers to the entry's subject. Prefer a specific phrase such as harbor archive over a broad word such as place. Avoid adding the same long list of general words to every entry.

Keep sentences, instructions, and background details in Content. A keyword list should be easy to scan and maintain.

Automatic and custom keywords

Keywords are generated when an entry is created. While you leave that list automatic, editing the entry's text can refresh it.

Once you change and save the keywords yourself, that entry keeps your custom list through later text edits. Opening the dialog or canceling an edit does not make the list custom.

Review custom keywords when the entry changes substantially. If Rowan switches from mint tea to lemon tea:

1. Correct Content and the short description, then save the entry.

2. Open Keywords.

3. Replace mint tea with lemon tea if it is in your custom list.

4. Save the keywords separately.

Accepting a suggested content change does not refresh a custom list for you. The same check is useful after renaming a person or place.

Remove all keywords

You can clear the list and save it. This removes those keywords; it does not delete the entry or its Content.

Saving an empty custom list does not switch the entry back to automatic keywords. The current dialog has no reset-to-automatic button. Add and save the words you want to use instead.

Keywords have their own Save action

The Save button in the keyword dialog saves only keywords. If you have unsaved changes to the entry's title, description, or Content, those edits remain in the editor and still need the entry's own Save button.

Similarly, saving the entry's text is not a substitute for saving a keyword edit in the dialog. For a straightforward workflow, finish and save the entry text first, then adjust its keywords.

Changing only keywords does not accept or dismiss a pending content suggestion. Continue to use Accept / Dismiss or Keep / Discard in the review panel for those decisions.

Saved keyword changes appear in History as Keywords changes. Like other edits to a shared book, they apply to every chat using that book.

Chronicle chapters and arcs

Open Keywords in a chapter or arc to inspect its list. The text is read-only and the dialog has a Close button instead of Save and Cancel.

Chapter and arc keywords are maintained automatically. Open an individual scene to edit that scene's keywords.

If you need to correct an event or its keywords, expand the chapter or arc and open the relevant scene. See Chronicle for the difference between these levels.

If something does not save

What you see	What to do
No Keywords button on a new entry	Save the entry first, then look below Content.
Save is disabled	Check whether the list has changed and whether it exceeds eight keywords. A save in progress also disables it.
The counter is lower than the number of lines	Blank lines and repeated identical lines are ignored.
Read-only text with a Close button	You opened a Chronicle chapter or arc. Open a scene to edit its keywords.
An older-version message	Copy the keyword draft and any unsaved entry text you need, reopen the book, and apply your changes to the latest entry.
A save error	Keep a copy of your keyword draft, check the message and connection, and retry. The dialog stays open after a failed save.
Old keywords remain after a text change	Check whether you previously saved a custom list. Custom keywords need to be maintained separately.

If your companion still misses information, also check the book selection, description, and Content. Troubleshooting walks through those checks.