Skip to content
Developer Codex
Organization

Organize with Tags

Your NPCs don’t organize themselves. Tags are the lightweight label system that lets you mark pages with cross-cutting descriptors — “draft”, “needs-revision”, “villain”, “location” — without forcing them into a rigid hierarchy. A page for the Shattered Spire can simultaneously be tagged “landmark”, “Exiled Court territory”, and “unfinished lore” without any of those categories owning the page.

Tags can be created from the tag management dialog or on the fly from any page’s tag bar.

From the tag management dialog:

  1. Open the tag panel in the sidebar or navigate to Settings → Tags.
  2. Click the + button or Create tag.
  3. Enter a name. Tag names can be up to 100 characters. Empty names are rejected.
  4. Optionally set a hex color (for example, #8b5cf6 for purple). Colors must be in #rrggbb format.
  5. Confirm to create the tag.

The tag appears in your workspace tag list with a usage count of 0 until it is assigned to pages.

  1. Open a page in the editor.
  2. Click the tag bar at the bottom of the editor content area.
  3. Start typing a tag name in the autocomplete field. Results filter by prefix as you type, ordered by how many pages already use that tag.
  4. Select the tag from the suggestions, or type a new name and press Enter to create it immediately.

The tag chip appears in the tag bar. You can assign multiple tags to the same page — all chips appear side by side.

Click the × on a tag chip in the page’s tag bar. The chip disappears and the association is removed. The tag itself continues to exist in your workspace and can be assigned to other pages.

Renaming a tag updates it everywhere it appears — across all pages that have it assigned and in full-text search results.

  1. Open Settings → Tags or the tag management dialog.
  2. Find the tag and click the edit action.
  3. Enter the new name and confirm.

Inklings re-indexes every page that has this tag so that searching for the new name surfaces those pages correctly.

  1. Open the tag management dialog.
  2. Find the tag and click its color swatch.
  3. Enter a new hex color in #rrggbb format.

The chip color updates everywhere the tag appears — on pages, in the tag bar, and in the sidebar tag filter.

When you end up with duplicates — “Sci-Fi” and “Science Fiction” both floating around — you can consolidate them.

  1. Open the tag management dialog.
  2. Select the source tag (the one to be absorbed) and choose Merge into….
  3. Select the target tag (the one to keep).
  4. Confirm the merge.

All page associations from the source tag transfer to the target tag. Pages that already had the target tag are not double-counted — Inklings deduplicates the associations. The source tag is deleted. Merging a tag into itself is rejected with a validation error.

Deleting a tag removes it from your workspace and removes its association from every page that had it assigned. The pages themselves are not affected.

  1. Open the tag management dialog.
  2. Find the tag and select Delete.
  3. Confirm the deletion.

Tag names are indexed in full-text search with high relevance weight. Searching for a tag name — for example, “worldbuilding” — surfaces pages tagged with it, even if the tag name does not appear in the page title or body content. This makes tags a powerful discovery tool across a large workspace.

Was this page helpful?