Connect Linear
Connect Linear to bring your projects and issue activity into Flowstate, where they become effort, cost, capitalisation and R&D evidence. Flowstate only reads from Linear.
You need access to integrations. Ask your Flowstate admin. For the whole set-up, including linking projects, see Connect your project tool.
Before you start
- Your people in Flowstate, with the email address they use in Linear. See People and teams.
- A Linear admin to approve the Flowstate app for your workspace.
You can connect one project tool at a time.
Connect Linear
Linear connects in one click. You approve the Flowstate app in Linear, with no key or token to copy.
- Go to Settings → Integrations, select Browse catalog and open Linear.
- Select Connect with Linear. Linear opens.
- Approve the Flowstate app for your workspace. You come back to Flowstate, which shows the workspace you’re Connected to.
- Choose the teams to bring in: All teams or Only these teams.
- Choose whether to Auto-create Flowstate projects.
- On the Data Mapping tab, under Project Source, choose Linear Projects or Issue Type. Do this before the first sync: changing it later means clearing out the projects created the first way.
- On the Sync Settings tab, choose how far back to read under Initial Sync History Limit, then turn on Scheduled Sync, choose a Time of Day and select Save Schedule.
- Match people and teams. See Match people and teams from your tools.
To come back to these settings, select Configure on the Linear row of Settings → Integrations.
Check it’s working
Go to Settings → Integrations → Sync Health and open the Linear tab. When the first sync has finished, the status is Healthy and the counts of Projects, Tasks, Users and Activities are above zero. See Check and fix syncing.
What syncs
- Projects, their issues, who each issue is assigned to, status changes and teams.
- Changes as they happen, through the Flowstate app, plus a full sync once a day at the time you choose.
- Nothing goes back to Linear.
Optional settings
These are on the Data Mapping tab.
| Setting | What it does |
|---|---|
| Initiative Sync | Brings Linear initiatives in as Flowstate initiatives. Choose Auto-create initiatives or Suggest for review, then select Save Initiative Sync. |
| Custom Field Mappings | Uses a Linear field to put a project in a cost centre, department or value stream, or to link it to a Flowstate project by name. Select Add Mapping, enter the field name (such as isCapex) in Source Field, choose a Field Type, then select Save Mappings. |
| Delivery Status Mapping | Matches Linear statuses to Flowstate’s delivery statuses. A linked project’s status then comes from Linear. |
| Effort Tracking Configuration | Chooses which work item types count towards effort, under Task Types to Include. This applies to your whole organisation. |
If the connection stops
If syncing stops and a red banner says “Linear authentication failed — sync is paused”, select Connect with Linear and approve the Flowstate app again.
Done when: the banner has gone. To sync straight away, select Sync now on Sync Health.
Start again or disconnect
On the Advanced tab, under Danger Zone:
- Purge LiveProjects deletes every project created from this connection. Use it only before syncing again with a different Project Source.
- Delete Integration removes the connection.
Neither can be undone.
If something’s not right
Nothing is showing yet. The first sync reads your history back as far as Initial Sync History Limit, so it takes a while. Sync Health shows Syncing until it’s done.
A project’s status keeps changing back. Its status comes from Linear. Change it in Linear, or adjust Delivery Status Mapping.
Syncing has stopped with an “authentication failed” banner. Connect again.
Someone’s work isn’t counted. They aren’t matched to a person, or aren’t in Flowstate yet. See Match people and teams from your tools.