> ## 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 Jira Server or Cloud data to Plane

> With the Jira importer, you can easily import issues, states, labels, priorities and user data from Jira to Plane and continue managing your existing projects.

## Import from Jira[​](#import-from-jira "Direct link to Import from Jira")

> **Role**: Workspace admins

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

To import Jira 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 Jira section. <img src="https://mintcdn.com/onestack/sTJ5vBeQfsXpM5SF/images/importers/importers/jira/import-jira-cloud-server.webp?fit=max&auto=format&n=sTJ5vBeQfsXpM5SF&q=85&s=90bdee35e5dbed350f5a0a681125185b" alt="Import from Jira" width="3822" height="1012" data-path="images/importers/importers/jira/import-jira-cloud-server.webp" />

3. In the **Jira to Plane Migration Assistant** screen, enter your **Personal Access Token**, **User email** and the **Jira domain** to allow Plane access to your Atlassian account. <img src="https://mintcdn.com/onestack/sTJ5vBeQfsXpM5SF/images/importers/importers/jira/jira-plane-migration-assitant.webp?fit=max&auto=format&n=sTJ5vBeQfsXpM5SF&q=85&s=34bf14ebe53425363fd8da9747ad3aac" alt="Connect Jira" width="2516" height="1088" data-path="images/importers/importers/jira/jira-plane-migration-assitant.webp" />

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

5. Click the **Import** button. <img src="https://mintcdn.com/onestack/sTJ5vBeQfsXpM5SF/images/importers/importers/jira/import-jira-data.webp?fit=max&auto=format&n=sTJ5vBeQfsXpM5SF&q=85&s=3154801fbe9448958b722a386f5a0a75" alt="Import Jira" width="2502" height="984" data-path="images/importers/importers/jira/import-jira-data.webp" />

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

7. **Configure Jira** Choose the workspace and project in Jira from where you want to import data. <img src="https://mintcdn.com/onestack/sTJ5vBeQfsXpM5SF/images/importers/importers/jira/configure-jira.webp?fit=max&auto=format&n=sTJ5vBeQfsXpM5SF&q=85&s=5147a6dfe90c5cb9a013fbcfc3c1af6d" alt="Configure Jira" width="2502" height="978" data-path="images/importers/importers/jira/configure-jira.webp" />

   <Info>
     If you're on a paid plan (Pro or higher), issue types in Jira will be imported as work item types in Plane. On the free plan, issue types from Jira won't be imported.
   </Info>

8. **Import users** Choose one of the following:

   * **Upload CSV** Click the **Upload CSV** button to import users to your Plane project. Refer to [Export users from a site](https://support.atlassian.com/organization-administration/docs/export-users-from-a-site/) to download the CSV file from Jira. *(recommended)*
   * **Skip user import** You can select the **Skip Importing User data** checkbox and manually add users later.
     <Warning>
       If you skip user import, work items and comments will show the name of the person who performed the migration, and the Assignees field will be empty.
     </Warning>
     <img src="https://mintcdn.com/onestack/sTJ5vBeQfsXpM5SF/images/importers/importers/jira/import-users.webp?fit=max&auto=format&n=sTJ5vBeQfsXpM5SF&q=85&s=edd0a85e817656fc79f70cf2ec285d93" alt="Import users" width="2508" height="1028" data-path="images/importers/importers/jira/import-users.webp" />

9. **Map states**

   1. Map **Jira status** to their equivalent **Plane states**.
   2. Select the **Auto create and map the remaining Jira states** checkbox to automatically create and map any missing states. <img src="https://mintcdn.com/onestack/sTJ5vBeQfsXpM5SF/images/importers/importers/jira/map-states.webp?fit=max&auto=format&n=sTJ5vBeQfsXpM5SF&q=85&s=af827a4001265610e26b0ebb9b8da701" alt="Map states" width="2494" height="1020" data-path="images/importers/importers/jira/map-states.webp" />

10. **Map priorities** Map the **Jira priorities** to the corresponding **Plane priorities**. If there's no match, select **None** in the **Plane priorities** list. <img src="https://mintcdn.com/onestack/sTJ5vBeQfsXpM5SF/images/importers/importers/jira/map-priorities.webp?fit=max&auto=format&n=sTJ5vBeQfsXpM5SF&q=85&s=a3fb4208183d123098bc08b86edf3c1e" alt="Map priorities" width="2492" height="1148" data-path="images/importers/importers/jira/map-priorities.webp" />

11. **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/sTJ5vBeQfsXpM5SF/images/importers/importers/jira/import-summary.webp?fit=max&auto=format&n=sTJ5vBeQfsXpM5SF&q=85&s=42f00e64ececf4092838264ca3b4e5d3" alt="Review mappings" width="2484" height="986" data-path="images/importers/importers/jira/import-summary.webp" />

12. The data migration begins and takes a few minutes to complete depending on the number of issues in your Jira workspace. <img src="https://mintcdn.com/onestack/sTJ5vBeQfsXpM5SF/images/importers/importers/jira/jira-import-complete.webp?fit=max&auto=format&n=sTJ5vBeQfsXpM5SF&q=85&s=3305f4dad0b82466ca937726099ac644" alt="Migration complete" width="2486" height="698" data-path="images/importers/importers/jira/jira-import-complete.webp" />

13. Once it's done, go to **Work items** in your Plane project to confirm that the data import is successful.

## Imported entities[​](#imported-entities "Direct link to Imported entities")

Here’s a quick look at what gets imported during the migration from Jira to Plane:

| Jira                            | 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 Jira issue.                                                                                                  |
| Sprint                          | Cycles                              | Includes the work items, start and end date.                                                                                                    |
| Components                      | Modules                             | Includes the work items.                                                                                                                        |

## Sync Jira to Plane[​](#sync-jira-to-plane "Direct link to Sync Jira to Plane")

After the import, if there are any new or updated issues in Jira, 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/sTJ5vBeQfsXpM5SF/images/importers/importers/jira/rerun-import.webp?fit=max&auto=format&n=sTJ5vBeQfsXpM5SF&q=85&s=8244e19b00c02e15628269d1d24e7cd3" alt="Sync Jira" width="1864" height="700" data-path="images/importers/importers/jira/rerun-import.webp" />
