Skip to content →

Jira Link

Use Jira link while trialing or transitioning to Linear so that you can use Linear while still keeping projects up to date in Jira.

If you are looking for a one-time import from Jira to Linear, use our importer.
Linear and Jira logos

Some companies choose to import issues and switch immediately, while others prefer to trial Linear on a small team first or need some time to make the full transition. For the latter, we built Jira link. The feature lets you connect Jira projects to a Linear team so that issues created in Jira are simultaneously created in Linear. Once issues complete in Linear, they'll be moved to completed in Jira so that the project in Jira stays up to date.

G then S to go to Settings > Workspace > Integrations > Jira link

Enable the integration in Linear from workspace settings under Workspace > Integrations > Jira Link. Enter your personal access token, email address and installation or cloud hostname and then select which Jira project to link to which Linear team. For the installation or cloud hostname, remember to remove the http:// and anything after .net.

We've set up the integration so that Jira projects map to teams in Linear. You can only link a Jira project to a single team in Linear, but you can configure the integration so that multiple Jira projects create issues in one Linear team.

Once the integration is enabled, anytime you create a new ticket in a linked Jira project, a copy of the same issue will be created in Linear. The Jira issue will include a link to the copied issue in Linear. The Linear issue will include the original title, description (including any embedded images), and a link to the issue in Jira.

New issues created through Jira link will be sent to Linear's Triage status if that feature is enabled, or to the first workflow status under Backlog if Triage is toggled off.

When linked issues are marked with a Completed or Canceled workflow status type in Linear, they will update and move the corresponding Jira ticket to the appropriate status.

If the linked issue in Jira is updated to Completed or Canceled workflow status type, the Linear issue will also update accordingly.

Changing either issue's status in other ways will have no affect on its paired issue.

Outside of marking a Jira ticket as done when completed or canceled, no other updates will be made or shared to the corresponding Jira ticket. The Linear issue functions separately from the Jira ticket, not affecting the experience on either tool, while making it easy to keep progress updated in Jira while using Linear. This is intentional, as the feature is meant to make it easier to trial and transition tools, not to use both tools at the same time. We do not plan to support syncing or extensive issue updates but welcome feedback on what would make this feature more useful.

You can manually link to JIRA tickets from the ... menu > Add Link > Jira Issue, or from CMD K "Link Jira issue"