Stories (Story ID)

The Story ID is a free-form identifier that connects an issue back to its original business requirement or user story. It is separate from the project's automatic key (e.g., SHOP-42) and can be any code or reference from your requirements management system.

Use Cases

• Track which product backlog requirement or user story an issue derives from
• Link issues to external systems (Jira, Confluence, spreadsheets, etc.)
• Group issues that implement the same user story
• Include the story identifier in exports for traceability reports

Setting the Story ID

1. Open an issue.
2. In the detail panel, find the Story ID field.
3. Enter the desired identifier (free text, max 100 chars).
4. Save.

Example values:

• US-001
• REQ-2024-087
• FEATURE/auth-flow
• HU-03

Story ID on the Board

The Story ID is displayed on the issue card on the board as a small tag below the title, making it easy to visually identify story groupings.

Story ID in the Timeline

In the sprint view of the Timeline, the Story ID column is available as an optional field in the sprint issue list.

Story ID in Export

When exporting issues (CSV or XLSX), the Story ID column is included automatically with each issue's value.

Filtering by Story ID

On the board and in the table view, you can filter issues by Story ID using the filter bar:

1. Click Filters → Story ID.
2. Type the identifier (partial search supported).
3. Only issues with a matching Story ID are displayed.