Import issues from other platforms including GitHub Issues, Jira, Asana, Pivotal Tracker, Clubhouse and Trello to Linear.
Issue Migration Assistant
Supports GitHub Issues, Jira, Clubhouse and Asana
Go to settings to import issues in just a few clicks. You don't need technical expertise to use the importer but will need to be a Linear admin.
In general, we map basic features such as labels to their Linear equivalent. Attachments are imported either as an inline image in the description or a link to the file. If we can match users, we will map assignees.
All imported issues include backlinks to the original issue URL from whatever service you imported it from as well. If you've imported issues previously, you'll see a history of past imports on the settings page. Imported issues do not count toward the 250 issue limit.
Issue Migration AssistantMigration Assistant: GitHub IssuesMigration Assistant: JiraMigration Assistant: ClubhouseMigration Assistant: AsanaCommon questionsCommand Line Interface (CLI) Import ToolKeyboard Shortcuts
Migration Assistant: GitHub Issues
OAuth into GitHub from the importer page, select the repo where your current Github issues live and then which team you want to import them into on Linear.
Github > Linear mapping
- Title > Title
- Description > Description
- Labels > Labels
- Projects > Projects
- Comments > Comments
Migration Assistant: Jira
Enter your personal access token, project key, email address and installation or cloud hostname and then start the import. For the installation or cloud hostname, remember to remove the
http:// and anything after .net.Jira > Linear mapping
- Summary > Title
- Description > Converted into markdown and used as issue description
- Priority > Priority
- Issue Key > Used in backlink
- Issue type > Added as label
- Release > Added as label
- Epic > Added as label
Migration Assistant: Clubhouse
Enter your Clubhouse workspace access token and Clubhouse team name, then select which Linear team to import issues into and start importing.
Clubhouse > Linear mapping
- Name > Title
- Description > Clubhouse markdown formatted description
- Tasks > Appended to the description
- External tickets > Appended to the description
- State > Mapped to the most similar Linear status
- Type > Added as label
- Tags > Added as label
- Owners > First owner added as assignee when possible
- Epic > Added as label
Migration Assistant: Asana
Enter your Asana personal access token and Asana team name, then select which Linear team to import issues into and start importing.
Note: We currently only support in app importing from Asana organizations. Make sure your Asana workspace is an organization before beginning an import, or convert your Asana workspace to an organization if it is not. If you do not want to convert your Asana workspace to an organization, check out our CLI import tool below.
Asana > Linear mapping
- Name > Title
- Priority > Priority
- Notes > Converted to markdown and used as issue description
- Attached images & files > Images are included in the description. Other files are converted to links and added to the issue description
- Tags > Added as labels
- Assignee > Assignee
- Projects > Projects
- Issues cannot belong to multiple projects in Linear, so one project will be chosen in the case of an issue with multiple Asana projects.
Common questions
What happens if I import more than 250 issues on the free plan?
Why didn't all of my issues import?
How do I delete an import?
How come I don't see my team's imports?
You can select imported issues in bulk with 
Selecting issues. Imported issues will be added with a label "imported" which you can use to filter for them (or remove if you don't need it).
Cmd/Ctrl A to quickly remove or change an issue property such as workflow status or label. Learn more in Selecting issues. Imported issues will be added with a label "imported" which you can use to filter for them (or remove if you don't need it).Command Line Interface (CLI) Import Tool
Supports importing issues from Trello, Pivotal Tracker and other Linear workspaces. The CLI also supports GitHub Issues, Jira, and Clubhouse but we recommend using the in-app importer instead unless you want to customize your import. The CLI tool is open source – contributions are welcome.
Our CLI tool uses CSV format. Access it at the link below or from the Import/Export page under workspace settings.
If you want to transfer issues from a different service, you have two options: build support for it and submit a pull request to the importer. Alternatively, if your old issue tracker exports to CSV, try modifying the CSV headers so that it fits one of the supported platforms. Find instructions on how to use the importer in the ReadMe.
linearapp/linear-import
Install depedencies: yarn install Run interactive importer: It's recommended to only import open issues to keep your Linear account more manageable. Open GitHub issues can be imported with your personal access token from GitHub's API. Supported fields: Jira project can be imported into a Linear team from the CSV export file.
https://github.com/linearapp/linear-import
Keyboard Shortcuts
G then S Open settings
Did we miss something? Have a question? Email us at hello@linear.app to let us know.