Convert project to a different template or type
Some teams may want to change their project template to enjoy features provided by a different template. Or, you may not need all the bells and whistles and want to simplify how your team track work with a basic template. There are many reasons why a team may want to change their project type or template.
This page explains how to:
Create a new project, ready to receive your current project’s issues.
Find your current project’s issues in the issue navigator.
Bulk move your current project’s issues into your new project, effectively changing its template.
This page will be useful to you if:
Your team currently works in one type of Jira project or a specific template (like Jira Software’s classic Scrum project or Jira Service Desk’s internal service desk project) and you want to migrate to a different project type or template (like Jira Software’s next-gen Kanban project or Jira Core’s task tracking project).
Your team has been tracking work for a while in one project type but now needs the features of a different type.
You’ve upgraded and your team wants to use the features of a different Jira product.
Before you begin
You must have the Administer Jira global permission to do the things on this page. Read more about global permissions.
Each Jira product comes with its own project templates. For example, Jira Software provides Scrum and Kanban templates for teams who work using Agile methodologies. Jira Service Desk comes with templates intended to help IT and customer service teams handle their incoming requests. Read more about the types of projects that come with each Jira product and their features.
Create a new project to receive your team’s work
You’ll need to have a new project available, so that the issues from your current project have a place to go. The first thing to do is create a new, clean project of the desired type.
To create a new project:
Choose Projects and select a project, or choose View all projects to visit the projects directory.
Select Create project.
Choose between a Classic project or Try a next-gen project.
Doublecheck that the project you’re creating is the right template. If not, click Change template, and select from the templates you have access to. You can switch between classic and next-gen project templates using the link at the bottom of the screen.
Enter a name for your new project, and hit Create.
You’ve got a new project ready to receive your team’s issues.
Start the migration process
Now that your new project is ready, you need to find the issues from your current project and move them into the new one. To make bulk changes to issues, you need to filter them in Jira’s issue navigator:
Choose Filters in the navigation bar.
From the sidebar, select All issues.
Click the Project filter, and select the project you want to migrate from. If you're looking at the Advanced searching mode, you need to select Basic.
- In the top-right corner, select more (•••) > Bulk change all.
Bulk move issues into their new home
Select the issues you want to migrate and hit Next.
Select Move Issues and hit Next.
On the Select Projects and Issue Types screen, select where the issues from your old project will go. Select a destination project and issue type, and hit Next. This is the issue type that each issue in your old project will become in the new project.
On the Map Status for Target Project screen, select a destination status for each status in your old project. This is the status that each issue in your next-gen project will take on in the new project.
On the final screen, click Confirm.
Things to keep in mind when you change project types and templates
Features differ between project types and templates. Be sure the new project you’re moving to has all the features your team needs to carry out their work. Read more about the types of projects that come with each Jira product and their features.
If your team’s current project uses custom schemes (for issue types, workflows, security, notifications, etc.), you’ll have to associate the new project with those schemes.
Sometimes things go badly. It’s always a good idea to create a backup before starting bulk operations. Read more about backing up your Jira Cloud site.
Things to keep in mind if you migrate from classic to next-gen
Next-gen projects and classic projects are technically quite different, so a few things can break when you migrate from a classic software project to a next-gen software project. For example:
Epic links and issue links: Any issue links in your classic project will not exist in your next-gen project. The issues themselves will still exist, but the links between them won't.
Subtasks: All subtasks will be lost in this migration process.
Custom fields: These must be recreated in your new next-gen project.
Story points estimation: This data will be lost, however you'll be able to start using story points estimation by enabling the Estimation feature in your next-gen project.
Stuck? Need more help?
Contact the Atlassian Support team if you need further assistance.