Import from Asana
Role: Workspace admins
To import issue types from Asana, make sure the Work item types feature is enabled in your Plane workspace.
- 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 Asana section.
-
In the Asana to Plane Migration Assistant screen, enter your Personal Access Token to allow Plane access to your Asana account.
- Click the Connect Asana button to link the accounts.
-
Click the Import button under the Imports section.
-
Configure Plane Select the Plane project where you want to import your Asana data and and click Next.
-
Configure Asana Choose the workspace and project in Asana from where you want to import data.
-
Map states Map Asana sections to their equivalent Plane states.
-
Map priorities Map the Asana priorities to the corresponding Plane priorities. If there’s no match, select None in the Plane priorities list.
-
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 Asana workspace.
- Once it’s done, go to Work items 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 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
After the import, if there are any new or updated issues in Asana, 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.
