Create, edit, and delete next-gen projects

Still need help?

The Atlassian Community is here for you.

Ask the community


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

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 Next-gen Scrum or Next-gen 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.

Edit your next-gen software project's details

In next-gen projects, you can edit the project's:

  • Icon
  • Name
  • Key
  • Category
  • Access

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 key, this abbreviation is the foundation of how work is tracked and referred to in Jira.

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.

Change who can access your next-gen software project

Next-gen projects can be personal and private. Or, they can be open for anyone on your Jira site to see. We recommend keeping your work open and accessible. Break down those silos!

But, if you want to restrict who can view or comment on issues in your project, you can change your project's access.

To change your project's access:

  1. From your project's sidebar, select Project settings > Details.
  2. In the Access drop down, select the level of access you want.
  3. Select Save details.

Your project's access level sets who can search, view and edit the project and its issues.

Next-gen software projects have three, simple access levels:

  • Open. When a project is open, anyone on your Jira site can view, create and edit issues in your project. Basically, Jira gives anyone who logs into your Jira site the Member role.
  • Limited. When a project is limited, anyone on your Jira site can view and comment on issues in your project. But, they can't edit them or create new ones. With this access, Jira gives anyone who logs into your Jira site the Viewer role.
  • Private. When a project is private, it's hidden from everyone on your Jira site. Only people added to the project can see it in their project directory, or its issues in search results. Other people on your site will never know the project exists. Jira admins can see private projects in the project directory, but they don't have access to view or interact with a private project's issues.

Read more about next-gen project roles.

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


  1. From your project's sidebar, select Project settings > Details.
  2. Select ••• > Delete project.
Last modified on Nov 27, 2019

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.