Get started with Jira
New to Jira? Check out our guides for new administrators and users.
This page will be useful to you if:
Your team currently works in a company-managed project, and you want to migrate to team-managed projects.
Your team currently works in a team-managed project, and you want to migrate to a company-managed project.
To create a team-managed project:
Choose Projects > Create project.
Select Work management under Project templates or Jira Work Management under Products. You can also select which kind of team you’re in to find a template that best suits your team’s project.
Learn about the available templates and select a template.
View the detailed information on the template and choose Use template.
Choose project type: Team-managed.
Give your project a name. You can change your template by selecting Change template.
Choose who can access your project if you’re on a Standard and Premium plan. You can choose whether your project is private, limited, or open.
Select Create.
We automatically generate a project key when the project is created.
If you want to move from a team-managed project to a company-managed project, your Jira admin will need to create a new company-managed project for you. Reach out to them for help. Learn more about creating company-managed projects.
To create a new company-managed project:
Choose Projects > Create project.
Select Work management under Project templates or Jira Work Management under Products. You can also select which kind of team you’re in to find a template that best suits your team’s project.
Learn more about the available templates and select a template.
View the detailed information on the template and choose Use template.
Choose project type: Company-managed.
Give your project a name. You can change your template by selecting Change template.
Choose who can access your project if you’re on a Standard and Premium plan. You can choose whether your project is private, limited, or open.
Select Create.
Now that you have an empty project waiting to receive your old project's issues, you can move all your existing issues into the new project using the issue navigator. To open the issue navigator, select Search > View all issues.
You need to have the relevant project permissions to move issues.
To move multiple issues from the issue navigator:
Adjust the search criteria to show the appropriate list of issues.
Select Import and bulk change issues (•••) and choose Bulk Change all <n> issues.
Select the issues you'd like to perform the bulk operation on, and select Next.
Select Move Issues and select Next.
Select a destination project and issue type, and select Next.
Select a value for any required fields for this move, and if available, decide whether you'd like to send email notifications. Select Next.
Review your changes and select Confirm, then Acknowledge.
Team-managed projects and company-managed projects are technically quite different. Here's a few things to consider when you migrate from a company-managed software project to a team-managed software project:
Components: Component fields are unique to every company-managed project in Jira. If you migrate issues with completed component field information, you will lose this data.
This data is not recoverable, even if you bulk move these issues back to the company-managed projects they came from.
Custom fields: These must be recreated in your new team-managed project. Team-managed project fields are independent from company-managed project custom fields. When you move issues to a team-managed project, Jira retains most of your issues' global custom field values (except component and version fields). But, Jira won’t map them to your team-managed project's fields. Your global custom field data is stored against your issues but the fields in your company-managed project are technically different from the fields in your team-managed destination, so they will appear blank. This data is not lost (except component and version fields). If you move your issues back to a company-managed project that supports the custom field, the original values stored against it reappear.
Report history: All reporting history is lost in this migration process. The Burnup report and Velocity report won't be migrated.
Project and issue keys: Project keys are unique and can never be reused in Jira. If you migrate your issues to another project, they will get new keys and the new project must have a different key of its own. If you migrate your issues using the process above, Jira will automatically redirect any links to your old issue keys.
Versions: Jira Work Management business projects do not support versions. Any version information is lost in this migration process.
This data is not recoverable, even if you bulk move these issues back to the company-managed projects they came from
Team-managed projects and company-managed projects are technically quite different. Here's a few things to consider when you migrate from a team-managed software project to a company-managed software project:
Board statuses: If you customized your team-managed board, you'll need to set up the same statuses in your company-managed project's workflow. Only Jira admins can create and modify statuses and workflows. Learn more.
Custom fields: If you customized the fields that appear on your team-managed issue types, you'll need to have a Jira admin recreate these fields in your new company-managed project's screen schemes and field configuration schemes as the data stored in these fields will be lost.
Issue types: If you added your own issue types to your team-managed project, you'll need to have a Jira admin recreate these using an issue type scheme that they associate to your new company-managed project. Learn more.
Project access: Access to company-managed projects is controlled by a permissions scheme. Only your Jira admin can update your company-managed project's permission scheme. Learn more.
Project and issue keys: Project keys are unique and can never be reused in Jira. If you migrate your issues to another project, they will get new keys and the new project must have a different key of its own. If you migrate your issues using the process above, Jira will automatically redirect any links to your old issue keys.
Was this helpful?