Learn how to mention Linear issues or projects in Cycle docs, create issues in bulk, and see their status in Cycle follow the ones from Linear.
Looking to connect product delivery and discovery? You're in the right place. Here's everything you need to know about integrating Linear with Cycle.

Table of content

The big picture is that you can map any Cycle feature/bug with a Linear project/issue, mirroring its status in real time. No more double-status entries! The same for GitHub and Jira will follow soon.
Check out the magic in action here! 😍
The logic is that Cycle status category will follow Linear status category. We don't map 1-1 each status inside categories. Once entering a status category, the doc will get the 1st status in this category.
To be more precise, we don't track the project status in Linear, we track the status of the related Linear issues. Let's explore all possible cases:
  • 100% of issues are "Todo" -> Cycle status is "Not Started"
  • At least 1 issue is "In progress" -> Cycle status is "Started"
  • All issues are "Done" -> Cycle status is "Shipped"
  • All issues are "Cancelled" -> Cycle status is "Canceled".
For the issues, we track their status category directly.
Make sure your delivery statuses in Cycle are in the "Started" category for a smooth process.
We recommend having only delivery statuses in the "In Progress" category and no things like "Ready to dev".


Follow these steps or click the interactive step-by-step tutorial below 👇
  1. 1.
    Open your workspace settings and go to "Integrations"
  2. 2.
    On the right, click on "Add new" and select "Linear issues"
  3. 3.
    Log in to your Linear account
Since you added the Linear integration, you probably have existing issues over there that aren't tied to a specific product requirements document (PRD) or product roadmap elements.
To get started, go to your feature, click on “Link” and choose a Linear project or issue. The issue/project doesn't exist yet? Create it right from here!

Mention issues or projects in Cycle

You can easily mention existing Linear issues in Cycle docs using the "/Linear issues" command. You can search by name or by ID.
When you mention it, the Linear project/issue will be automatically linked to the current Cycle doc.
This will also add a comment in Linear with a link to the corresponding Cycle doc so you can easily have everyone on the same page.
Feels good to create Linear issues right from the spec, side-by-side with customer insights, right? 😎

Edit a Linear issue or project

To edit a mentioned issue, click the down-facing arrow at the left of the Linear issue to expand it. From here, you can edit its status and/or assignee.
Every edit, no matter which tool it was made from, is safely synced in Linear and Cycle at all times.

Create (multiple) Linear issue(s)

To create a single Linear issue, highlight any text in a Cycle doc and click on the Linear icon in the toolbar. You can also use the keyboard shortcut "⌘+3".
To create multiple issues at once, highlight a bullet list of issues to create, and use the Linear icon in the toolbar or the keyboard shortcut, ⌘+3.
Note: Creating Linear issues in bulk will only work on bullet lists.
Create multiple Linear issues at once
Last modified 1d ago