# The label system

Labels are tags that you can attach to your steps to organize, categorize, and easily find them. They work as flexible tags that help you structure your story as it grows.

# Status labels

Status labels let you track the writing progress of each step. They use the status: prefix and are shown as a small colored dot next to the type icon in the step list, and as a colored badge in the binder.

• status:draft — Draft, the step is being written
• status:review — Under review, the step is awaiting validation
• status:done — Completed, the step is finalized

# Player labels

In multiplayer mode, player labels let you quickly identify which player each step is intended for. They use the player: prefix and appear as a text badge next to the description in the list, and with a gamepad icon on the graph nodes.

• player:1 — Step intended for player 1 (the host)
• player:2 — Step intended for player 2
• player:3, player:4... — Steps for other players

# Folder labels

Folder labels let you group your steps by chapter, act, or any other logical organization. They use the folder: prefix and are used by the binder to build your story's tree structure. They also show up as a folder icon on graph nodes. They do not appear in the step list.

• folder:chapter1 — Groups the steps of chapter 1
• folder:chapter2 — Groups the steps of chapter 2
• folder:prologue — Groups the steps of the prologue

# Color labels

Color labels provide quick visual categorization. They use the color: prefix (e.g. color:red, color:blue). They appear as a small colored dot in the binder and as a colored left border on graph nodes. They are not shown in the step list.

# Custom labels

Beyond predefined labels, you can create any custom label to meet your specific needs. These free-form tags appear as text labels on graph nodes and remain available internally for searching and for documenting your intent.

# Where labels are displayed

Each view displays labels differently based on the kind of information it emphasizes:

• Step list — status: labels appear as a colored dot next to the type icon, and player: labels (multiplayer mode) as a text badge next to the description. Other types are not shown here.
• Binder — folder: labels structure the tree, status: labels appear as colored badges and color: as small dots next to the description.
• Graph view — Every label type is visible on nodes: status: as a colored tag, folder: with a folder icon, player: with a gamepad icon, color: as a colored left border, and custom labels as text tags.

# Filtering steps by labels

Several views let you filter steps by label:

• Step list — Filter by player (player:) in multiplayer mode.
• Binder — Filter by status (status:draft, review, done).
• Graph — Filter by player, available in the flow view.