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.

Overview

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

Configure

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.

Basics

Projects map to Linear Teams

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.

Automatically create Linear issues

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 Linear issue will include the title, description (including any embedded images), and a link to the issue in Jira. New issues will be sent to Triage if they feature is enabled, otherwise to the first workflow status under Backlog.

Close issues

When linked issues are marked with a Completed workflow status in Linear, they will update and move the corresponding Jira ticket to the Done column in Jira. If the Linear issue is moved to Canceled, it will update the Jira ticket to Canceled as well. This is the only update that will happen; in-between statuses will not move the Jira ticket automatically.

Update issues

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.