Import your Linear data to Plane
The Linear importer is in a private beta. Contact us to try it out.
With the Linear importer, you can easily import issues, states, labels, priorities and user data from Linear to Plane and continue managing your existing projects.
Import from Linear
Role: Workspace admins
To import Linear issues to a Plane project, follow these steps:
-
Click the ∨ icon next to your workspace name on the sidebar and select Workspace settings.
-
Select Imports on the right pane and click the Import button in the Linear section.
-
In the Linear to Plane Migration Assistant screen, enter your Personal Access Token to allow Plane access to your Linear account.
-
Click the Connect Linear button to link the accounts.
-
Click the Import button in the Imports section.
-
Configure Plane
Select the Plane project where you want to import your Linear data and and click Next.
-
Configure Linear
Choose the Linear team from where you want to import data.
-
Map states
Map Linear states to their equivalent Plane states.
-
Summary
Review the mappings and make any changes if needed. Click Back to adjust, or click Confirm to start the migration.
-
The data migration begins and takes a few minutes to complete depending on the number of issues in your Linear workspace.
-
Once it's done, go to Issues in your Plane project to confirm that the data import is successful.
Imported entities
Here’s a quick look at what gets imported during the migration from Linear to Plane:
| Linear | Plane | Notes |
|---|---|---|
| Labels | Labels | |
| Status | States | |
| Issue priorities | Priorities | |
| Users | Users | |
| Issues | Issues | |
| Relations | Parent | Includes only parent-child relationships |
| Issue comments | Issue comments | Includes username and timestamp. If you skip user import during migration, comments will show the name of the user who performed the migration. |
| Issue attachments | Issue attachments | |
| Reporter | Created by | |
| Created | Created at | |
| Assignee | Assignees | If you skip user import during migration, this will be blank. |
| Issue types | Labels | Prefix in Issue title | |
| Images in the Issue description | Images in the Issue description | |
| Summary | Issue title | |
| Start date | Start date | |
| Due date | Due date | |
| Linked Issues | Links | Includes backlinks to the original Linear issue. |
| Sprint | Cycles | Includes the issues, start and end date. |
| Components | Modules | Includes the issues. |
Sync Linear to Plane
After the import, if there are any new or updated issues in Linear, you can easily sync these changes to Plane:
- Go to Workspace settings.
- Select Imports on the right pane.
- Click the Re run button next to the project you want to sync.
