@linear/import
v2.1.1
Published
Import helpers for uploading issues to Linear
Downloads
543
Keywords
Readme
Note Linear now has a migration assistant for importing from Asana, Jira, Shortcut, and GitHub without using the CLI.
Please see the documentation for more information. If you would like to import data from other services not listed above this CLI may still be useful.
linear-import
Install the CLI:
yarn global add @linear/import
or
npm i --location=global @linear/import
Run interactive importer:
linear-import
Importers
It's recommended to only import open issues to keep your Linear account more manageable. Note that creation and modification dates on issues will not carry over.
GitHub
Open GitHub issues can be imported with your personal access token from GitHub's API.
Supported fields:
- Title
- Description
- Labels
- (Optional) Comments
Jira CSV
This method is deprecated. We recommend importing Jira projects through the in-product importer instead of the CLI, which also offers a CSV import option but imports more fields. If you proceed, the following fields are supported:
Summary
- Issue titleDescription
- Converted into markdown and used as issue descriptionURL
- URL of Jira issuePriority
- Issue priorityIssue key
- Used to build backlink to original Jira issueIssue Type
- Added as a label- (Optional)
Release
- Added as a label
Asana CSV
Asana projects can be imported into a Linear team from the CSV export file.
Following fields are supported:
Name
- Issue titleNotes
- Converted into markdown and used as issue descriptionPriority
- Issue priorityTags
- Added as a labelAssignee
- Issue assignee
Pivotal Tracker CSV
Pivotal Tracker projects can be imported into a Linear team from the CSV export file. It only imports chores
, features
, and bugs
.
Following fields are supported:
Title
- Issue titleDescription
- Converted into markdown and used as issue descriptionLabels
- Added as a labelOwned By
- Story ownerURL
- URL of Pivotal Tracker storyCreated at
- Preserves the story creation date
Shortcut CSV
Shortcut workspaces can be imported into a Linear team from the CSV export file. It only imports chores
, features
, and bugs
.
Following fields are supported:
Name
- Issue titleDescription
- Shortcut markdown formatted descriptionTasks
- Appended to the descriptionExternal Tickets
- Appended to the descriptionState
- Mapped to the most similar Linear statusType
- Added as a labelTags
- Added as labelsOwners
- Story owner (only the first is preserved)URL
- URL of Shortcut story, also appended to the descriptionCreated at
- Preserves the story creation date
Trello JSON
Trello board 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.
Following fields are supported:
Name
- Issue titleDescription
- Trello markdown formatted descriptionURL
- URL of Trello cardLabels
- Added as a labelAttachments
- Added as links in the description- (Optional)
Comments
- Added in the description
Linear CSV
Linear CSV exports (Settings → Import / Export → Export CSV) can be imported into Linear again. You can use this to import issues from one workspace to another. Archived issues won't be imported.
Following fields are supported:
Title
- Issue titleDescription
- Issue descriptionPriority
- Issue priorityStatus
- Issue state (workflow)Assignee
- Issue assignee (user's full name)Labels
- Added as a label
Todo
- [x] Automatic image uploads
- [ ] Assignees (pick from a list)
- [ ] Created at (requires API change)
License
Licensed under the MIT License.