How-To2026-08-2110 min read

How to Migrate from Jira to Linear (Step-by-Step)

Migrating from Jira to Linear is one of the most common engineering tool transitions for growing software teams. Jira's power becomes a liability when teams spend more time managing the tool than doing product work. Linear's opinionated design and speed make it the top destination for Jira refugees. The migration itself is technically straightforward — the challenge is workflow mapping and team adoption.

This guide covers the complete Jira-to-Linear migration: data export, import configuration, workflow mapping, and team onboarding.

Step-by-step guide

01

Export your Jira data

In Jira, go to Settings (gear icon) > System > Backup & Restore > Backup for Cloud. Download the full XML backup. For active issues only, use Jira's Issue Export feature: go to your project board, filter to the issues you want to migrate, and click Export > Export CSV (all fields). The CSV export is usually cleaner for Linear import than the full XML.

02

Map Jira concepts to Linear

Before importing, map your Jira concepts to Linear equivalents: Jira Projects → Linear Teams, Jira Epics → Linear Projects, Jira Sprints → Linear Cycles, Jira Story/Task/Bug → Linear Issues (same type, differentiated by labels), Jira Components → Linear Labels. Write this mapping in a doc so the team understands the new language.

03

Use Linear's native Jira importer

In Linear, go to Settings > Import > Jira. Linear has a native Jira import that connects directly to your Jira Cloud instance via OAuth. Authorize Linear to access your Jira workspace. Select the projects to import. Linear maps Jira issue types, statuses, priorities, and assignees to Linear equivalents automatically.

04

Configure Linear workflows before importing

Before running the import, set up your Linear team workflows: define custom states, add team members, configure cycles settings, and create project labels. Issues imported before workflow setup will use default states that you then need to manually update — set up workflows first.

05

Run a test import with a small project

Select one small Jira project (10-20 issues) for a test import. After import, manually verify: all issues are present, priorities are correctly mapped, assignees are set, comments are preserved, and sprint/cycle assignments are correct. Fix any mapping issues before running the full import.

06

Communicate the migration plan to the team

Two weeks before migration: announce the change, share the Jira-to-Linear concept mapping guide, schedule a 30-minute Linear overview for the team. One week before: run a training session on Linear's keyboard shortcuts and workflow. On migration day: freeze Jira (read-only mode), run the full import, and make Linear the official tool.

07

Handle the post-migration Jira archive

Do not delete the old Jira project immediately. Set Jira to read-only for 60 days so the team can reference historical issues. After 60 days, export the Jira data as a final archive (XML backup) and store it in Google Drive. Then deactivate the Jira subscription.

Common mistakes

Migrating all historical data

Issues closed more than 6 months ago do not need to be in Linear. Migrate only open issues, current sprint issues, and recently closed issues. Historical data in Linear becomes noise; archive old Jira issues instead.

Running the migration mid-sprint

Migrating during an active sprint creates confusion about which tool is current. Plan the migration to start at the beginning of a new sprint cycle when the transition is cleanest.

Not training the team before migration

Dropping Linear on the team with no training generates resistance and support requests. A 30-minute overview covering the key workflow differences between Jira and Linear prevents 80% of adoption friction.

Tips

Use Linear's "Import from Jira" feature rather than CSV import — it handles more field mappings automatically

Create a Linear cheat sheet with the team's most-used keyboard shortcuts and share it in Slack on migration day

Set Linear as the default tool in your sprint planning meeting calendar invite the week before migration

Keep Jira read-only for 60 days to ensure no historical context is lost during the transition

How Vantage helps

Vantage integrates natively with Linear. If you are migrating from Jira to Linear to improve your engineering workflow, Vantage can generate Linear-native tickets from your PRDs with dependency graphs that leverage Linear Projects and Cycles from day one.

Frequently asked questions

Spend less time on setup, more on decisions

Vantage connects your tools and generates specs grounded in real data. Free to start.

Free to start. No credit card required.

Related reading