Skip to content →

Importer

Import data from other tools into Linear.

Icons demonstrating services you can import to Linear

We have two tools for importing data to Linear. A concierge-style issue migration assistant takes you through the import process from start to finish. Our command line interface importer is more rudimentary and lets you import issues by uploading a CSV.

ServiceIssue Migration AssistantCLI Importer
Jira
Asana
GitHub Issues
Shortcut (Clubhouse)
Pivotal Tracker
Trello
Linear > LinearContact Support
Other services

G then S to go to Settings > Workspace > Import/Export

F then filter by Migrated label to find issues imported via the Issue Migration Assistant

The issue migration assistant guides you through the process of importing issues to Linear from Asana, Jira, Shortcut or GitHub. If you're coming from another Linear workspace, please contact us at support@linear.app and we'll help run the import.

The issue migration assistants connect to your other issue tracker via their API to import issues. You'll need to authenticate to other services or share details with us so that we can view and transfer the issue data to Linear.

In general, we map basic features to their Linear equivalent. Labels will be imported as team-level labels. Embedded images 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 in the previous issue tracker. If someone on your team imported issues in the past, you'll see a history of past imports on the settings page.

Find steps for the various importers below.

Tip: Issues imported with the Migration Assistant will be labeled Migrated. Filter for that label, then m Cmd A to take bulk actions on those issues or remove the label completely. You can also remove the label under Team settings > Labels, which will remove it from migrated issues.

Go to Settings > Workspace > Import/Export to import issues with our issue migration assistant. You don't need technical expertise to use the importer but will need to be a Linear admin.

  1. Enter your Asana personal access token. You can obtain your personal access token by navigating to your Asana developer console.
  2. Enter your Asana team name
  3. Select which Linear team to import issues into.
  4. Click Next to start importing.

We'll map fields in Asana to these fields in Linear:

AsanaLinear
PriorityPriority
NotesIssue description (converted to Markdown)
Attached filesAdded to description, all files except images are converted to links
TagsLabels (team-level)
AssigneeAssignee
ProjectsProjects
CommentsComments

Issues cannot belong to multiple projects in Linear, so one project will be chosen if issues are assigned to multiple Asana projects.

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, use the CLI importer.

Go to Settings > Workspace > Import/Export to import issues with our issue migration assistant. You don't need technical expertise to use the importer but will need to be a Linear admin.

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.

By default, we will import any projects associated with the repos you choose. You will also have the option to choose to import all projects from the organization level.

We'll map fields in GitHub Issues to these fields in Linear:

GitHub IssuesLinear
TitleTitle
DescriptionDescription
LabelsLabels (team-level)
ProjectsProjects
CommentsComments

Go to Settings > Workspace > Import/Export to import issues with our issue migration assistant. There are two options for Jira imports: uploading a CSV or providing your API credentials. If importing over API credentials, you'll also need to be an admin in Jira of the project you're importing.

To use the CSV option, export a CSV from Jira by searching for your project under advanced issue search in JQL (project=TEST, for instance). Export the data as a CSV and choose the "all fields" option. Attach this file in Linear where prompted and optionally add data in the other requested fields.

To use the API credentials path, 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 following .net.

You will be guided through configuration options during the import process. You will have the option to import into an existing team or a newly created team on your workspace. You will also have the option to map each Jira user to an existing Linear user, invite Jira users to your Linear workspace or take no action for certain Jira users.

If you wish to match your issue IDs in Jira with those in Linear, see our FAQs for details on how to accomplish this.

We'll map fields in Jira to these fields in Linear:

JiraLinear
SummaryTitle
DescriptionConverted into markdown and used as issue description
PriorityPriority
Issue KeyUsed in backlink
Issue typeMapped to the most similar Linear status
Type Added as label (team-level)
ReleaseAdded as label (team-level)
EpicAdded as project (or optionally as label)
CommentsComments
EstimateEstimate
Due dateDue date

Go to Settings > Workspace > Import/Export to import issues with our issue migration assistant. You don't need technical expertise to use the importer but will need to be a Linear admin.

Enter your Shortcut workspace access token and Shortcut team name, then select which Linear team to import issues into and start importing.

We'll map fields in Shortcut Issues to these fields in Linear:

ShortcutLinear
NameTitle
DescriptionIssue description
TasksAppended to the description
External ticketsAppended to the description
StateMapped to the most similar Linear status
Story typeAdded as label (team-level)
TagsAdded as label (team-level)
OwnersFirst owner added as assignee when possible
EpicCreated as project
CommentsComments
EstimateEstimate
Due dateDue date
PriorityPriority

To move data from one Linear workspace to another, please contact support@linear.app so we can facilitate the transition for you. Include the URLs of the workspaces you wish to import, and which workspace you'd like to keep using moving forward.

Linear (old)Linear (new)
TitleTitle
DescriptionDescription
EstimateEstimate
LabelsLabels
Due dateDue date
CommentsComments
Workflow stateWorkflow state
ProjectProject
RelationshipsRelationships
Sub-issuesSub-issues

To import issues from other services, such as Trello or Pivotal Tracker, use our open source CLI importer.

While this import type can also be used to customize imports that have a migration assistant, we don't recommend this as the CLI importer will not import data supported by the migration assistant like comments, projects or cycles.

Our Command Line interface (CLI) tool uses CSV format and requires some technical expertise. Access it at the link or from Settings > Workspace > Import/Export.

Trello boards can be imported into a Linear team from the JSON export file, which can be obtained by going into Board → Show Menu → More → Print and Export → Export as JSON.

We'll map fields in Trello to these fields in Linear:

TrelloLinear
NameTitle
DescriptionTrello markdown formatted description
URLURL of Trello card
LabelsAdded as a label (team-level)
AttachmentsAdded as links in the description
Comments (Optional)Added in the description

While the import is limited to these fields, the importer is open source (contributions welcome) so it's possible to customize the CLI importer.

Pivotal Tracker projects can be imported into a Linear team from the CSV file exported from Pivotal. It only imports chores, features, and bugs.

We'll map fields in Pivotal Tracker to these fields in Linear:

Pivotal TrackerLinear
TitleTitle
DescriptionDescription (converted to Markdown)
Labels Added as a label (team-level)
Owned ByAssignee
URLURL of Pivotal Tracker story
Created atPreserves the story creation date

While the import is limited to these fields, the importer is open source (contributions welcome) so it's possible to customize the CLI importer.

Did we miss something? Have a question? Email us at support@linear.app to let us know.