Connect Linear and sync your roadmap both ways
Connect Linear from the Integrations page, import projects and issues into your roadmap, and keep status and target dates in sync in both directions.
The Linear integration connects your roadmap to the work your engineering team tracks in Linear. Link a roadmap item to a Linear project or issue and its status and target date follow Linear. Turn on two-way sync and moving a card on the roadmap board updates Linear too. You can also import existing Linear projects and issues straight into your roadmap.
Connect Linear
Open Integrations in the sidebar and find Linear under Issue tracking.
Select Connect and approve access in Linear.
Back in Releaseo, select Configure on the Linear card and pick your Team. Status mapping and imports come from this team.
Turn on two-way sync
Under Status sync, Linear sets the status of every roadmap item that follows a primary link. The Board moves update Linear toggle decides whether changes also flow back:
Off (one-way): Linear is the source of truth. Linked items are locked on the board and only move when their status changes in Linear.
On (two-way): moving a card on the roadmap board also changes its status in Linear, and changes in Linear still move the card in Releaseo.
Map Linear statuses to roadmap columns
Under Status mapping, choose which roadmap column each Linear status puts an item in. Issue and project statuses are grouped by category. Leave a status on Default to follow its category:
Open (Backlog, Todo, Project: Backlog, Project: Planned) → Planned (or Backlog)
In progress (In Progress, Project: In Progress) → In progress
Done (Done, Project: Completed) → Ready to announce
Cancelled (Canceled, Duplicate, Project: Canceled) → Not planned (or Archived)
Select Save mapping when you're done.
Done never announces automatically. It only marks an item ready to announce. You release it in Releaseo, which tells the people waiting for it.
Import from Linear
Bring existing Linear work onto your roadmap instead of recreating it by hand.
In the Linear settings, select Import from Linear.
Choose the Team.
Under What to import, choose Projects (one card per project) or Issues (one card per issue). For issues, use From project to import a single project's issues, or keep All issues in the team.
Select Import.
Each imported project or issue becomes a hidden roadmap item linked as its primary source, so its status and target date keep following Linear. Review the new cards and make them visible from the item's Audience tab when you're ready to share them.
Anything already imported is skipped, so you can run the import again safely.
Cancelled and duplicate issues are skipped.
Link a roadmap item to Linear
Open a roadmap item and go to the Links tab.
Under Linear, select Link issue.
Choose Create a new issue to create one in Linear from this item, or Link an existing issue and enter its type (project or issue) and id.
Pick a Role, then select Link issue.
Primary drives the item's status and target date.
Supporting receives customer demand without changing the item's status.
Once linked, the item follows Linear and customer demand from linked feature requests reaches engineering.
Check sync health
The Sync health section shows the connection state, the last sync, and any sync problems from the last 7 days.
Disconnect Linear
Select Disconnect Linear to stop syncing. Cards stay on the roadmap, and nothing in Linear is changed.
Was this article helpful?
Still stuck? Contact us and mention this article.