> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onestack.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Import your Linear data to Plane

> 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[​](#import-from-linear "Direct link to Import from Linear")

> **Role**: Workspace admins

<Check>
  To import issue types from Linear, make sure the [Work item types](/core-concepts/issues/issue-types) feature is enabled in your Plane workspace.
</Check>

To import Linear issues to a Plane project, follow these steps:

1. Click the **∨** icon next to your workspace name on the sidebar and select **Workspace settings**.

2. Select **Imports** on the right pane and click the **Import** button in the Linear section. <img src="https://mintcdn.com/onestack/4HoiF2FbNysKRwdw/images/importers/importers/linear/import-linear.webp?fit=max&auto=format&n=4HoiF2FbNysKRwdw&q=85&s=655b0f2835254106294bb445582f395e" alt="Import Linear" width="2520" height="1056" data-path="images/importers/importers/linear/import-linear.webp" />

3. In the **Linear to Plane Migration Assistant** screen, enter your **Personal Access Token** to allow Plane access to your Linear account. <img src="https://mintcdn.com/onestack/4HoiF2FbNysKRwdw/images/importers/importers/linear/linear-plane-migration-assistant.webp?fit=max&auto=format&n=4HoiF2FbNysKRwdw&q=85&s=e38a1f8dfaa9284c9a4209c721bbd602" alt="Connect Linear" width="2510" height="968" data-path="images/importers/importers/linear/linear-plane-migration-assistant.webp" />

4. Click the **Connect Linear** button to link the accounts.

5. Click the **Import** button in the **Imports** section. <img src="https://mintcdn.com/onestack/4HoiF2FbNysKRwdw/images/importers/importers/linear/import-linear-data.webp?fit=max&auto=format&n=4HoiF2FbNysKRwdw&q=85&s=4c88b8d1c1ba69b6dfbfb336c2d81f31" alt="Import Linear data" width="2484" height="952" data-path="images/importers/importers/linear/import-linear-data.webp" />

6. **Configure Plane** Select the Plane project where you want to import your Linear data and and click **Next**. <img src="https://mintcdn.com/onestack/sTJ5vBeQfsXpM5SF/images/importers/importers/linear/configure-plane.webp?fit=max&auto=format&n=sTJ5vBeQfsXpM5SF&q=85&s=d93af248a200691826c9c49c1518b45c" alt="Configure Plane" width="2508" height="1014" data-path="images/importers/importers/linear/configure-plane.webp" />

7. **Configure Linear** Choose the Linear team from where you want to import data. <img src="https://mintcdn.com/onestack/sTJ5vBeQfsXpM5SF/images/importers/importers/linear/configure-linear.webp?fit=max&auto=format&n=sTJ5vBeQfsXpM5SF&q=85&s=ead56db8033d4d73f8e1cd6e584563f8" alt="Configure Linear" width="2496" height="986" data-path="images/importers/importers/linear/configure-linear.webp" />

8. **Map states** Map **Linear states** to their equivalent **Plane states**. <img src="https://mintcdn.com/onestack/4HoiF2FbNysKRwdw/images/importers/importers/linear/map-states.webp?fit=max&auto=format&n=4HoiF2FbNysKRwdw&q=85&s=39f4c8a4a66020089afd1ec28c830609" alt="Map states" width="2498" height="1346" data-path="images/importers/importers/linear/map-states.webp" />

9. **Summary** Review the mappings and make any changes if needed. Click **Back** to adjust, or click **Confirm** to start the migration. <img src="https://mintcdn.com/onestack/4HoiF2FbNysKRwdw/images/importers/importers/linear/import-summary.webp?fit=max&auto=format&n=4HoiF2FbNysKRwdw&q=85&s=9ed42430d0c47bca8690e4452d09f7b8" alt="Review mappings" width="2504" height="974" data-path="images/importers/importers/linear/import-summary.webp" />

10. The data migration begins and takes a few minutes to complete depending on the number of issues in your Linear workspace. <img src="https://mintcdn.com/onestack/4HoiF2FbNysKRwdw/images/importers/importers/linear/import-complete.webp?fit=max&auto=format&n=4HoiF2FbNysKRwdw&q=85&s=1e7cf5caf38e19f81a4366e338179f79" alt="Migration complete" width="2478" height="1014" data-path="images/importers/importers/linear/import-complete.webp" />

11. Once it's done, go to **Work items** in your Plane project to confirm that the data import is successful. <img src="https://mintcdn.com/onestack/4HoiF2FbNysKRwdw/images/importers/importers/linear/verify-import.webp?fit=max&auto=format&n=4HoiF2FbNysKRwdw&q=85&s=fe8e91aa18fea0e2dc56760f8dc74e64" alt="Verify import" width="3012" height="1158" data-path="images/importers/importers/linear/verify-import.webp" />

### Imported entities[​](#imported-entities "Direct link to 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                          | Work items                          |                                                                                                                                                 |
| Relations                       | Parent                              | Includes only parent-child relationships                                                                                                        |
| Issue comments                  | Work item 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               | Work item 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 Work item description |                                                                                                                                                 |
| Summary                         | Work item title                     |                                                                                                                                                 |
| Start date                      | Start date                          |                                                                                                                                                 |
| Due date                        | Due date                            |                                                                                                                                                 |
| Linked Issues                   | Links                               | Includes backlinks to the original Linear issue.                                                                                                |
| Cycles                          | Cycles                              | Includes the work items, start and end date.                                                                                                    |
| Projects                        | Modules                             | Includes the work items.                                                                                                                        |

## Sync Linear to Plane[​](#sync-linear-to-plane "Direct link to 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:

1. Go to **Workspace settings**.
2. Select **Imports** on the right pane.
3. Click the **Re run** button next to the project you want to sync. <img src="https://mintcdn.com/onestack/4HoiF2FbNysKRwdw/images/importers/importers/linear/rerun-import.webp?fit=max&auto=format&n=4HoiF2FbNysKRwdw&q=85&s=2e671a482adf2f9cf7dbdc2dfb6d424b" alt="Sync Linear" width="3364" height="716" data-path="images/importers/importers/linear/rerun-import.webp" />
