Ready to switch from Jira to ClickUp? This article walks you through the import process.

Use the new importer to download your data from Jira, then upload it into ClickUp using our step-by-step process. The new importer allows versions of Jira hosted on-premises to be imported into ClickUp. The new importer also allows you to map statuses, Custom Fields, and users.

Use the legacy importer to use the API to import data from Jira into ClickUp.

Feature availability and limits vary by plan and user role. Learn more

Time spent on issues in Jira is automatically assigned to the person who performs the import. We recommend creating notes in Jira on each issue being imported to record who tracked time for each issue.

There is a 50GB file size upload limit when importing from Jira. If your Jira data is larger than 50GB, please contact our Professional Services team.

Uploaded Jira files are available to be reimported for up to 30 days before they are permanently deleted.

What imports

The following information is included when importing into ClickUp:

• Jira ID
  • The Jira ID is automatically imported into a new Text Area (long text) Custom Field called Jira ID
• Task descriptions
  • Attachments from task descriptions are imported as task comments
  • Links to tasks do not import
• Subtasks
• Assignees
• Followers
  • Jira followers and reporters become followers
• Task Dependencies and relationships
• Comments, their authors, and attachments
  • Links to tasks do not import
  • Private comments are imported as public comments. 
• Attachments and their authors
  • Imported Attachments have a size limit of 1GB
• Custom Fields: Jira's built-in custom fields can be imported into ClickUp, but user-defined custom fields cannot. The following Custom Fields are transferable to ClickUp:
  • Dropdown
  • Labels
  • Text
  • Number
  • Date
    • Dates must follow an mm/dd/yyyy format. The mm-dd-yyyy format will not import.
  • URL
  • User
• Statuses

What doesn't import

The following information is not included when importing into ClickUp:

• Recurring tasks
• Timestamps
• Priority field
• Depending on the type, Jira Label fields import differently:
  • Built-in Label fields are imported into ClickUp as Tags.
  • Label fields are imported into ClickUp as Label Custom Fields.

Step 1: Select source of import

1. In the upper-left corner, click your Workspace avatar and select Settings.
2. In the All settings sidebar, select Imports / Exports.
   • If your Workspace doesn't have an import or export history, the Select source of import page opens. In the Import from apps section, select Jira.
   • If your Workspace has an import or export history, the Imports / Exports page opens. Select Import Items. On the Select source of import page, select Jira.

Step 2: Select your Jira version

1. On the Select your Jira version page, choose a version:
   • Jira Cloud: Select this option if you use a cloud-hosted version of Jira.
   • Jira Software: Select this option if you use a server or on-premise version of Jira.
2. Click Next.
3. In the pop-up, sign in to your Wrike account.

Step 3: Import from Jira Cloud or Jira Software

To retrieve your Jira data:

1. Follow the directions to download your Jira data.
2. Click Next.

Step 4: Upload or select backup

To upload your Jira data into ClickUp:

1. Drag and drop or browse for your Jira .zip file.
   • If the Jira file has been altered, the import will not complete.
2. Once the upload is complete, you are automatically taken to step 5.

Depending on the size of your file, this step can take up to a few hours. 

Step 5: Backup summary

ClickUp automatically scans your Jira data. When it completes the scan:

1. Check the summary to see the number of users, Projects, Issues, and attachments found.
2. Click Next.

Step 6: Choose Jira Projects

You can bring all of your Projects over at once, or bring them over in batches using multiple imports.

To select the Projects you want to import:

1. Show archived Projects by toggling on Show archived in the upper-right corner.

2. Check the checkbox to the right of each Project you want to import or click the double checkmark in the upper-right to select all Projects.

   

3. Click Next.

Step 7: Hierarchy setup

Customize how your ClickUp Hierarchy is set up. Because you can create unique statuses for each List in your Workspace, your decision affects status mapping later in the import process.

To set up your Hierarchy:

1. Use the Preview window to decide which option is best for your team:

• Epics as tasks & Stories as subtasks: In one Epics List, create a task for every epic and a subtask for every story. Select this option if you want epics and stories to share the same statuses. Items that are not epics or stories will be placed in a separate Non-Epics List.
  
• Epics and Stories related as tasks: In one Folder, create a List for all your epics and a List for all your stories. Related epics and stories will be linked via ClickUp relationships. Select this option if you want epics and stories to have different statuses.
  
• Click Next.

The Nested Subtasks ClickApp is automatically enabled when you import from Jira.

Step 8: Import Jira Projects

To import your Jira Projects:

1. Using the dropdown menu, choose a Space to import your Jira Projects to.
2. Click Next.

Step 9: Import Jira users

To map Jira users to ClickUp users:

1. Use the dropdown menus to the right of each user to map them. The following options are available:

• Invite as new user: Invite this person to your ClickUp Workspace as a new ClickUp user.
• Inactive user: Do not map this user to your ClickUp Workspace.
• Existing ClickUp user: Map this user to an existing user profile in your ClickUp Workspace.
• Click Next.

Step 10: Custom Fields mapping

To map your Jira Custom Fields to ClickUp Custom Fields:

1. Use the dropdown menus to the right of each Jira field to map them to new or existing ClickUp Custom Fields. Some fields, such as dropdown menus, have additional levels of mapping available.
   
2. Click Next.

Step 11: Status mapping

To map your Jira statuses to ClickUp statuses:

1. Use the dropdown menus to the right of each Jira status to map them.
2. Customize your ClickUp statuses. Click any status to rename it. Click any status color to change it.
3. At the bottom, click Complete.

Finish the import

Congratulations! Back at the Import/Export page, you can track the progress of your import. You can continue to use your Workspace while you wait for the import to complete.

You'll see Import Completed when it is finished.

Manage large imports

Import time varies depending on the size of the file and your internet connection.

The following tips can help you manage large imports from Jira.

Optimize file size

Before exporting, delete old projects and attachments from Jira to make the file smaller.

Additionally, remove large attachments from Jira, then add them back into ClickUp after importing.

Import in batches

To import more efficiently, we recommend importing in batches. Bring in one or a few Jira projects at a time. This saves time, improves feedback, and makes fixing issues easier.

Selective attachment removal

If the file is still large, take out attachments that aren't needed for the projects you're importing. Keep the entities.xml file at the top level of the zip.

Import attachments selectively

For imports with lots of attachments, remove unnecessary ones from the zip before importing. This reduces re-uploading after the import.