How to create custom statuses in Linear
Add a custom status to your Linear team workflow: open your team settings, go to Statuses, and create a new status in the Started group in a minute.
Quick answer
Open the workspace menu, choose Settings, then open your team and select Statuses. Click Create new workflow state in the group where the status belongs, such as Started. Type a name, then click Create. The new status then appears in that group's list alongside In Progress.
Steps at a glance
- Open the workspace menu
- Choose Settings
- Open your team settings
- Select Statuses
- Click Create new workflow state in a group
- Name the status and click Create
Interactive demo
Summary
Statuses define the workflow that issues go through from start to completion. Adding your own lets the team's board match how you actually work.
Step-by-step guide
Step 1
Open the workspace menu
Click the Arclet Content Workspace Menu at the top of the sidebar. The menu lists workspace-level options.
Step 2
Open Settings
Choose Settings in the menu. Linear opens the settings area on the Preferences page.
Step 3
Open your team settings
In the settings sidebar, click your team, Arclet Content, under your teams. The team overview page opens.
Step 4
Open Statuses
Under Issues, click Statuses. The description says Customize the statuses issues go through.
Step 5
Add a status to the Started group
The Issue statuses page groups statuses as Backlog, Unstarted, Started, Completed and Canceled. Click Create new workflow state next to the Started group.
Step 6
Name the new status
A form opens with Name and Description fields. Type a name in the Name field, for example In Review.
Step 7
Create the status
Click Create to save the status. The form closes.
Step 8
Find your new status in the list
Your new status now appears in the Started group, below In Progress.
Why this matters
Your team reviews work before it ships, but every issue jumps from In Progress straight to Done. You add a status for that stage, so the workflow shows where each issue really stands.
Frequently asked questions
Which group should a new status go in?
Pick the group that matches the stage. A review stage fits Started, next to In Progress.
Can I add a description to a status?
Yes. The form has a Description field next to Name.
Related guides
Continue with more step-by-step guides for getting work done.
How to change issue status in LinearChange the status of a Linear issue from Todo to In Progress with the status menu on the issue page, then confirm the move in the activity feed.
How to create custom labels in LinearCreate a custom label in Linear: open Settings, go to Labels, click New label, name it and press Enter to add it to your Issue labels list.
How to add comments to issues in LinearLearn how to add a comment to a Linear issue: open the issue, click the comment box under Activity, write your note, and post it with Submit comment.
Create interactive demos like this one — free, no coding required.
Start for free →