Manage workflows and statuses

Set up your project’s issue workflow (statuses and transitions).

Understand statuses

Statuses represent where an issue is in its lifecycle:

• Backlog — Not yet started
• In Progress — Currently being worked on
• In Review — Waiting for review
• Done — Complete

Your project may have custom statuses.

View current statuses

1. Go to Settings > Workflows or Statuses
2. See all statuses and their order

Create a custom status

1. Go to Settings > Workflows
2. Click + New Status
3. Enter:
   • Name — e.g., “Testing”, “Blocked”, “On Hold”
   • Category — Backlog, In Progress, or Done
   • Color (optional) — Visual indicator
4. Click Create

The status is now available for issues.

Reorder statuses

1. Go to Settings > Workflows
2. Drag statuses to reorder them
3. This affects how they appear on the board

Set default status

1. Go to Settings > Workflows
2. Click a status
3. Toggle Default to mark it as the starting status for new issues
4. Click Save

Create workflow rules (if supported)

Some projects support workflow rules:

• “Auto-move to Done when all subtasks are marked done”
• “Notify team when status changes to Blocked”

Check Settings > Automation if available.

Status best practices

Train your team on what each status means

Keep statuses simple (3–5 is ideal)

Use a consistent naming convention (all verbs or all nouns)

Ensure statuses flow logically (Backlog → In Progress → In Review → Done)