Get started with Jira Work Management
New to Jira Work Management? Check out our guides for new administrators and users.
Import data directly from Asana into Jira Work Management
Moving your work from Asana to Jira Work Management just got easier. Using the Asana importer, you can directly import projects from Asana into Jira Work Management. This can help save the effort of manually moving data and ensure the project information is relevant and accurate.
If you’re looking to import your work into Jira Software and Jira Service Management, you can do so using a CSV file. Learn how to use the CSV importer
Structure of your Asana project in Jira Work Management
When you use the Asana importer to import your project, it directly pulls information from your Asana account and creates a similar project structure and hierarchy in Jira Work Management.
Here’s how your Asana project data will be structured in your new business project:
Sections from Asana, such as To do, Doing, Done, etc., will be imported to Jira Work Management as one of the following:
Epic
Category
Tasks from Asana will be imported to Jira Work Management as issues.
Subtasks from Asana will be imported as subtasks. To maintain a similar hierarchy as Asana, each subtask will be linked to its parent subtask within an issue.
Once your Asana project is imported, you can customize the issue hierarchy to your needs.
Asana standard fields and custom fields supported in Jira Work Management
Both Asana and Jira Work Management have two types of fields:
Standard or system fields: These fields are “built-in” or part of the software by default.
Custom fields: These fields are customizable based on the user’s needs.
During import, the Asana importer maps the standard/system and custom fields from an Asana project to the new business project.
Admins can create and import data into both company-managed and team-managed projects.
Users with the permission to create projects can only create and import data into team-managed projects but won’t be able to move users into the new project. All user fields in the new project will be unassigned and user tags in comments will appear as plain text.
Standard or system fields
Asana standard fields are mapped to Jira system fields in the following manner:
Asana standard field | Jira Work Management system field |
|---|---|
Task name | Summary |
Section header | Issue status |
Assignee | Assignee |
Created by | Reporter |
Description | Description |
Due on | Due date |
Start date | Start date |
Collaborators | Watchers |
Tags | Labels |
Stories | Comment |
Project | Project |
Likes | Voters |
Subtasks | Subtasks |
Asana fields that aren’t a part of the standard list will be created as custom fields in Jira Work Management.
Custom fields
Here’s how custom fields will be mapped in Jira Work Management:
Asana field | Jira Work Management custom field |
|---|---|
Single-select | Dropdown |
Multi-select | Multi-select |
Text (short form) | Text |
Text (long form) | Paragraph |
Date (Only date values) | Date |
Date (including time values) | Timestamp |
People | Multi-user picker |
Number | Number |
Percent | Number |
Currency | Number |
Formula | Number |
Since custom fields are a premium feature in Asana, only standard fields will be imported from a free Asana account. You can create custom fields in your business project after your import is complete.
Import data using the Asana importer
Admins can create and import data into both company-managed and team-managed projects.
Users with the permission to create projects can only create and import data into team-managed projects but won’t be able to move users into the new project. All user fields in the new project will be unassigned and user tags in comments will appear as plain text.
To directly import your data using the Asana importer:
From the navigation bar, select Projects > Create a new project.
From the sidebar, go to More > select Import data.
Select Import to a new business project (Only admins need to select this option. Users with Create project permission will be directed to the import page).
From the Import from apps section, select Asana.
5. Select Allow in the OAuth screen to provide access to your Asana account.
6. Select the Asana workspace and the Asana project from where you’d like to move your data. Select Next.
7. Customize the name of your business project, and select Next.
The Key will automatically be selected for you. You can customize it if needed. You can also modify the Project name and Key later in the Project settings.
8. The Review details screen will summarize how your Asana data will be imported in three sections:
Project hierarchy: View how the Asana project structure will be replicated in Jira Work Management.
Field mapping: View and customize how your Asana standard and custom fields are mapped in Jira Work Management.
Import attachments: You can choose to import or not import attachments into your new project.
9. Select Import when you’re ready to start importing your data.
The importer will automatically start moving the data from Asana in the background, and the progress bar will indicate the status of your import. You can continue to work on other things and return to the project page to see the progress of your import.
Once the data is imported, your Asana tasks will show on the board view as issues in your new project. Learn more about the board view
If your import fails or is partially complete, you should be able to download an error log at the end of the import. Use the troubleshooting guide to fix errors and try importing your project again.
Contact support if you’re facing any issues with your import.
Customize fields in your business project
Admins can create and import data into both company-managed and team-managed projects.
Users with the permission to create projects can only create and import data into team-managed projects but won’t be able to move users into the new project. All user fields in the new project will be unassigned and user tags in comments will appear as plain text.
You can customize how the Asana fields are imported in your business project during the import.
The Review details screen will summarize how your data will be mapped to the new business project. Select Field mapping. This screen will show how your Asana data is automatically mapped.
Here you can:
Alter how your Asana data is mapped.
Use the toggle buttons to choose not to include specific fields in your import.
To customize your fields:
Select the dropdown of the field you want to edit.
You can either select an existing field from the options provided or select a custom field that best suits the format of your field. If you select a custom field, it’ll take the same name as your Asana field.
Once you’ve customized your fields, select Back to Review details to head back to the Review details screen. Your changes will be saved.
Few notes on customizable fields
The Summary and Issue status are required fields in Jira Work Management. They can’t be modified or excluded from an import.
Although Assignee, Due date, and Start date fields can be omitted from your import, we suggest including them for a better Jira Work Management experience.
When the assignee field is excluded from an import, assignee information will not be displayed in issues, comments, and tags.
When Due date and/or Start date fields are excluded from an import, users won’t be able to view issues in Timeline view.
Was this helpful?