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
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.
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.
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.
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.
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.
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.
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.