Import Jira projects into ClickUp.
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.
-
Import your items from Jira into ClickUp!
What you'll need
- Importing from Jira is available on all ClickUp plans.
- Only Workspace owners and admins can start an import from Jira.
What imports
The following information is included when importing into ClickUp:
- Task descriptions
- Attachments from task descriptions are imported as task comments
- Links to tasks do not import
- Subtasks
- Assignees
- Watchers
- Jira followers and reporters become watchers
- Task dependencies and relationships
- Comments, their authors, and attachments
- Links to tasks do not import
- 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 transferrable to ClickUp:
- Dropdown
- Labels
- Text
- Number
- Date
- URL
- User
- Statuses
Import from Jira
Workspace owners and admins can start Jira imports.
Step 1: Select Source of Import
To begin your import from Jira:
- In the lower-left corner, click your avatar.
- Select Import/Export.
- Click Start Import.
- Select Jira Software.
- Click Import from Jira.
Step 2: Select your Jira version
After starting the import:
- Select the version your team uses:
- Note: If you are using Jira Software, change any custom issue types you have that represent Epics to the standard Epic issue type before continuing.
- 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.
- Click Next.
Step 3: Import from Jira Cloud or Software
To retrieve your Jira data:
- Follow the directions to download, unzip, and extract your Jira data into a folder.
- Click Next.
Step 4: Upload or select backup folder
To upload your Jira data into ClickUp:
- Click browse and locate the folder with your Jira data.
-
Click Next.
Step 5: Folder Summary
ClickUp automatically scans your Jira data. When it completes the scan:
- Check the summary to see the number of users, Projects, Issues, and attachments found.
- 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:
- 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. Show archived Projects by toggling on Show archived in the upper-right corner.
- 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:
- 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 of your Epics and a List for all of 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:
- Using the dropdown menu, choose a Space to import your Jira Projects to.
- Click Next.
Step 9: Import Jira users
To map Jira users to ClickUp users:
- 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:
- 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.
- Click Next.
Step 11: Status mapping
To map your Jira statuses to ClickUp statuses:
- Use the dropdown menus to the right of each Jira status to map them.
- Customize your ClickUp statuses. Click any status to rename it. Click any status color to change it.
- 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.
-
Use the legacy importer to import your items from Jira into ClickUp.
When using the legacy importer, versions of Jira that are hosted on-premises cannot be imported.
Prepare your tasks in Jira (legacy)
All time spent in Jira is assigned to the ClickUp user who performed the import. Because of this, we recommend making a note on each task being imported of who tracked time on the task and how much.
Before starting the import, make sure you have access to all the projects you want to bring into ClickUp.
Start the import in ClickUp (legacy)
To begin the import process:
- In ClickUp, click your avatar in the lower-left corner.
- Click Import/Export.
- Click Start Import.
- Select Jira Software.
- Click Import from Jira.
Create an application link in Jira (legacy)
To begin the Jira authorization process:
- In Jira, click the Jira icon in the upper-left.
- Click the settings icon in the upper-right.
- Click Products.
- Click Application links.
- Paste the URL
https://clickup.com/jira
. - Click Create new link.
- In the popup, click Continue.
- Type
ClickUp
into the Application Name field. - Click Continue.
Set up your application link (legacy)
To set up your application link:
- Click the pencil icon on the right.
- In the left sidebar, click Incoming Authentication.
- Paste
clickupclient
into the Consumer Key field. - Head back to the import page in ClickUp and paste the base URL of your Jira instance, ending with
.net/
. Click Next to receive your Jira key. - Back in Jira, scroll down and paste your key into the Public Key field.
- Click Save.
Structure your ClickUp import (legacy)
The remainder of the import will be done in ClickUp.
Step 1: Import projects
On the left, you'll see all of your Jira projects.
On the right, you choose what to do with these projects:
- Import into existing Space: Import the project into a Space you already created.
- Import into new Space: Import the project into a brand new Space
- Don't import project: Do not import the project.
Tip: When you import Jira projects, we'll automatically import your Jira statuses and subtasks.
Step 2: Import users
On the left, you'll see all the users from your Jira import.
On the right, you choose what to do with these users:
- Select a user: Use this when the Jira user is already in your Workspace.
- Invite user by email: Use this if the Jira user isn't currently a member of your Workspace.
- Don't import user: Do not import the user.
Warning: It is not possible to import Jira users into ClickUp later on.
Step 3: Map priorities
After you've imported projects and users, you can map Jira priorities to ClickUp Priorities.
Step 4: Additional options
After you map priorities, you have a few final import options:
- Include done issues: Include done issues in your import.
- Separate Jira issue types into separate ClickUp Lists: Organize different issue types from Jira into different ClickUp Lists.
- Include attachments: Include your Jira attachments in your import. Imported attachments have a file size limit of 1GB.
- Tip: It is not recommended to include attachments if you are on the Free Forever Plan due to the storage cap.
- Include Custom Fields: Include Jira custom fields in your import and automatically create new ClickUp Custom Fields from them.
Tip: Add story points to your ClickUp Workspace by creating a new Custom Field during the import process.
After your import, we recommend taking advantage of the Multitask Toolbar to move items around in bulk.
Updated