> ## 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 Asana data to Plane

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

## Import from Asana[​](#import-from-asana "Direct link to Import from Asana")

> **Role**: Workspace admins

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

To import Asana 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 Asana section. <img src="https://mintcdn.com/onestack/sTJ5vBeQfsXpM5SF/images/importers/importers/asana/import-asana.webp?fit=max&auto=format&n=sTJ5vBeQfsXpM5SF&q=85&s=ef2eeb3cfca37fb370f3c3b38d5732e3" alt="Import from Asana" width="2520" height="1056" data-path="images/importers/importers/asana/import-asana.webp" />

3. In the **Asana to Plane Migration Assistant** screen, enter your **Personal Access Token** to allow Plane access to your Asana account. <img src="https://mintcdn.com/onestack/sTJ5vBeQfsXpM5SF/images/importers/importers/asana/asana-plane-migration-assistant.webp?fit=max&auto=format&n=sTJ5vBeQfsXpM5SF&q=85&s=940f9c9874be7004de5d38a9be6b3e07" alt="Connect Asana" width="2500" height="972" data-path="images/importers/importers/asana/asana-plane-migration-assistant.webp" />

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

5. Click the **Import** button under the **Imports** section. <img src="https://mintcdn.com/onestack/sTJ5vBeQfsXpM5SF/images/importers/importers/asana/import-asana-data.webp?fit=max&auto=format&n=sTJ5vBeQfsXpM5SF&q=85&s=356ec48c9caa2e96484483cf614d3357" alt="Import Asana" width="2510" height="968" data-path="images/importers/importers/asana/import-asana-data.webp" />

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

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

8. **Map states** Map **Asana sections** to their equivalent **Plane states**. <img src="https://mintcdn.com/onestack/sTJ5vBeQfsXpM5SF/images/importers/importers/asana/map-states.webp?fit=max&auto=format&n=sTJ5vBeQfsXpM5SF&q=85&s=abaf97ec7eadd83c8ed2998a7b47d3db" alt="Map states" width="2496" height="1056" data-path="images/importers/importers/asana/map-states.webp" />

9. **Map priorities** Map the **Asana 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/asana/map-priorities.webp?fit=max&auto=format&n=sTJ5vBeQfsXpM5SF&q=85&s=47e9d746ad84dff5a95a1d0712932747" alt="Map priorities" width="2504" height="1014" data-path="images/importers/importers/asana/map-priorities.webp" />

10. **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/asana/import-summary.webp?fit=max&auto=format&n=sTJ5vBeQfsXpM5SF&q=85&s=fad1a6ed85da25b78ad6c657660c4cb4" alt="Review mappings" width="2492" height="920" data-path="images/importers/importers/asana/import-summary.webp" />

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

12. 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 Asana to Plane:

| Asana                           | 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 Asana issue.                                                                                                 |

## Sync Asana to Plane[​](#sync-asana-to-plane "Direct link to Sync Asana to Plane")

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