Learn how to create a next-gen software project, and edit it's details, project key, or icon.

The following information only applies to next-gen projects

If you're unsure what type project you need help with, check the bottom of your project sidebar. If you see the Give feedback and Learn more menu items, you're in a next-gen project. If you don't, you're in a classic project.

By default, anyone can create next-gen projects. Out of the box, Jira Software gives end users the Create next-gen projects global permission. Jira admins can prevent users from creating next-gen projects by managing which groups are granted this permission. Read more about global permissions.

To find out if you can create your own project, choose the Jira icon ( or ) > Projects. If you see a Create project button, then you're all set. If not, check with your Jira admin for help creating a project.

Create a next-gen software project

To create a next-gen project:

  1. Choose the Jira icon ( or ) > Projects.
  2. Select Create project.
  3. Select Try a next-gen project.
  4. Give your project a name. You can change your template to choose either Scrum or Kanban by selecting Change template.
  5. Choose who can access your project.
  6. Select Create.

We automatically generate a project key when the project is created.

Project names are unique in Jira. They are always visible to Jira administrators and anyone with the Administer Jira global permission. Avoid using confidential or sensitive terms in your project's name. If you need to label a project with confidential or sensitive information, we recommend using a codename, instead.

Edit your next-gen software project's details

In next-gen projects, you can edit the following project details:

  • icon, which helps teams across your Jira site visually identify your project

  • name, which appears when people in your Jira site search, browse directories, or use the project switcher

  • key, which is typically the shorthand version of the project's name

  • category, which helps larger organizations label and filter similar projects in directories

To change these details: From your project's sidebar, select Project settings > Details.

Change your next-gen software project's icon

Project icons help give a face to your project's name. They appear in the project sidebar and in your site's list of all projects.

To change your project's icon:

  1. From your project's sidebar, select Project settings > Details.
  2. Under the current icon, select Change icon.
  3. Choose from a default icon or upload your own.
  4. Select Save details.

Change your next-gen project's key

Project keys provide a shorthand for the issues in your project. Together with an issue's sequential number, they form a unique identifier called an “issue key”. This abbreviation is the foundation of how work is tracked and referred to in Jira. You’ll see issue keys:

  • On issues themselves, as a label

  • In search results and saved filters

  • On cards on your boards or in a project's backlog

  • In links connecting pieces of work

  • In the issue's URL

  • Anywhere you need to reference the work you're tracking

To change your project's key:

  1. From your project's sidebar, select Project settings > Details.
  2. In the Key field, enter your desired key. Your project's key must:
    • be at least two characters long
    • start with an uppercase letter
    • and, contain only uppercase letters or numbers
  3. Select Save details.

After you change a key, we recommend communicating the change to your team. For example, board filters and dashboard filter gadgets need to be updated with the new key.

Assign or change your next-gen project's category

Project categories help group similar projects and service desks across your Jira site. They can be used in advanced search, filters, reports, and more. Your Jira admin creates and manages the categories that are available. Learn more about adding and deleting project categories.

To assign or change your project's category:

  1. From your project's sidebar, select Project settings > Details.
  2. Under Category, use the dropdown to assign your project a category.
  3. Select Save details.

Delete your next-gen software project

If you delete a project, only a Jira admin can recover it from a backup or an XML copy (if one exists!). This isn't the most fun thing to do, so make sure you truly want to delete the data associated with your project.

To delete your next-gen software project:

  1. From your project's sidebar, select Project settings > Details.
  2. Select ••• > Delete project.