Skip to main content

Tags

Tags help you organize and categorize your story elements with visual labels. Use them to track character roles, document status, priority levels, or any other categorization that makes sense for your project.

Tags management tab showing a list of project tags

Quick Start​

  1. Open your project and navigate to the Tags tab in the project menu
  2. Click "Create Tag" to add a new tag
  3. Enter a name, choose an icon, and select a color
  4. Click Create to save your tag

Creating Tags​

Tags are created at the project level and can be applied to any element within that project.

Tag Properties​

Each tag has the following properties:

PropertyDescription
NameA short, descriptive label (required)
IconA Material icon to visually identify the tag
ColorOne of 16 preset colors for visual distinction
DescriptionOptional text explaining the tag's purpose

Create Tag Dialog​

Create tag dialog with name input, color palette, and icon grid

The create/edit dialog shows:

  • Preview: See how your tag will look with the selected name, icon, and color
  • Color palette: 16 carefully chosen colors that work well in both light and dark modes
  • Icon grid: Common icons suitable for tagging (roles, status, priority, etc.)

Managing Tags​

Editing Tags​

To edit an existing tag:

  1. Find the tag in the Tags tab
  2. Click the Edit (pencil) button
  3. Modify the name, icon, color, or description
  4. Click Save
Edit tag dialog showing existing tag properties

Deleting Tags​

To delete a tag:

  1. Click the Delete (trash) button on the tag card
  2. Confirm the deletion
warning

Deleting a tag removes it from all elements that have it applied. This action cannot be undone.

Using Tags on Elements​

Tags can be applied to characters, locations, items, and other worldbuilding elements.

Adding Tags to Elements​

  1. Open an element (character, location, etc.)
  2. Find the Tags field in the element's properties
  3. Type to search existing tags or select from the dropdown
  4. Click a tag to add it to the element

Quick Tag Creation​

When adding tags to an element, you can create new tags on the fly:

  1. Type a name that doesn't match any existing tag
  2. Click "Create '[name]'" in the dropdown
  3. The tag is created with default icon and color
  4. Edit the tag later from the Tags tab to customize its appearance

Removing Tags from Elements​

Click the X on any tag chip to remove it from the current element.

Tag Color Reference​

The 16 available tag colors are chosen for:

  • High contrast: Readable in both light and dark modes
  • Visual distinction: Each color is clearly different from the others
  • Professional appearance: Balanced saturation levels
ColorHex CodeSuggested Use
Crimson#DC143CImportant/Urgent
Firebrick#B22222Critical/Danger
Orange Red#FF4500Warning/Attention
Dark Orange#FF8C00In Progress
Forest#228B22Complete/Success
Sea Green#2E8B57Approved/Ready
Light Sea#20B2AAReview/Pending
Steel Blue#4682B4Info/Reference
Dodger Blue#1E90FFPrimary/Main
Royal Blue#4169E1Secondary
Blue Violet#8A2BE2Special/Magic
Dark Violet#9400D3Rare/Unique
Medium Purple#9370DBCreative/Ideas
Slate Gray#708090Archived/Inactive
Blue Gray#607D8BDefault/Neutral
Sienna#A0522DHistorical/Past

Best Practices​

Consistent Naming​

  • Use clear, concise names
  • Be consistent with capitalization (e.g., always "Draft" not sometimes "draft")
  • Avoid abbreviations that might be unclear

Logical Groupings​

Consider organizing your tags by purpose:

  • Role tags: Protagonist, Antagonist, Supporting Cast
  • Status tags: Draft, Review, Complete, Published
  • Priority tags: High Priority, Normal, Low Priority
  • Theme tags: Romance, Conflict, Mystery

Don't Over-Tag​

  • Focus on categories that help you find and organize content
  • Too many tags can become as unhelpful as no tags at all
  • Consider if a tag will actually be useful for filtering or searching

Exporting and Importing Tags​

Tags are included when you export a project, and they're restored when you import:

  • All tag definitions are preserved
  • Tag assignments on elements are maintained
  • Colors and icons transfer correctly

This makes it easy to:

  • Share project templates with pre-defined tags
  • Back up your project structure
  • Move projects between devices

Dark Mode Support​

Tags are designed to look great in both light and dark modes:

Tags in dark mode showing proper contrast

The color palette was specifically chosen to maintain readability and visual distinction regardless of your theme preference.