robotsnoindex

description

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

description

Learn how to create a next-gen service project, and edit its details, key, or icon.

robotsnoindex

Are you on the right help page?

The following information only applies to next-gen projects.

To check which type project you need help with, look at the bottom of your project’s left-hand sidebar:

  • If you see an icon stating You’re in a next-gen project with Give feedback and Learn more menu items, you're in a project.

  • If you don't, you're in a classic project. Check out our classic project documentation.

By default, anyone can create next-gen projects. Out of the box, Jira SoftwareJira Service Management 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 Projects in the navigation bar. If you see the Create project option, 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 Projects > View all projects.
  2. Select Create project and choose Select next-gen.
  3. Give your project a name. You can change your template to choose either Scrum or Kanban by selecting Change template.
  4. Choose who can access your project.
  5. 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.

Create a next-gen service project

To create a next-gen service project:

  1. Choose Projects > View all projects.
  2. Select Create project and choose Select next-gen.
  3. Give your project a name. You can change your service project template by selecting Change template.

  4. Choose who can access your project.

  5. Select Create.

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

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

  • project lead, who is usually the project administrator for your next-gen project
  • default assignee, which is a role to which all issues created in the project are assigned to

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

Edit your next-gen service project's details

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

  • icon, which helps teams across your Jira site visually identify your service 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 service project's name

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

  • project lead, who is usually the project administrator for your next-gen service project
  • default assignee, which is a role to which all requests created in the project are assigned to

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 service project's icon

Icons help give a face to your service project's name. They appear in the service project sidebar and in your site's list of all other Jira projects.

To change your service 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.

Change your next-gen service project's key

Project keys provide a shorthand for the requests in your service project. Together with an request'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 Service Management. You’ll see issue keys:

  • On requests themselves, as a label

  • In search results and saved filters

  • In your queues and reports

  • In links connecting pieces of work

  • In the request's URL

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

To change your service project's key:

  1. From your project's sidebar, select Project settings > Details.
  2. In the Key field, enter your desired key. Your service 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.

Assign or change your next-gen project's category

Assign or change your next-gen service project's category

Project categories help group similar software, service, and business projects 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 your next-gen project lead

The project lead is a next-gen project is usually the project administrator, who controls and manages a project's settings.

You may want to change the project lead as people move in and out of your team in a longer-term project.

To change your project's lead:

  1. From your project's sidebar, select Project settings > Details.
  2. In the Project lead field, set a new person to lead the project.
  3. Select Save.

Change your next-gen service project's lead

The project lead is a next-gen project is usually the project administrator, who controls and manages a project's settings.

You may want to change the project lead as people move in and out of your team in a longer-term project.

To change your project's lead:

  1. From your project's sidebar, select Project settings > Details.
  2. In the Project lead field, set a new person to lead the project.
  3. Select Save.

Add or change your next-gen project's default assignee

When issues are created in your project, you can set a default assignee. This is useful for open projects where everyone on the site can report tasks to your project.

The default assignee is typically a team member who prioritizes or validates that reported issues are meant for their team and distributes these tasks to their team members accordingly. By default, they receive a notification when someone creates an issue in the project.

If you’re not able to change the default assignee, then check if you’ve enabled Allow unassigned issue under system Jira’s general configuration. Learn more about configuring Jira application settings.


To change your project's default assignee:


  1. From your project's sidebar, select Project settings > Details.
  2. In the Default assignee field, nominate your project's default assignee.
  3. Select Save.


The default assignee can only be either Unassigned, or the Project lead. If you want a specific person to be the default assignee, you'll need to change the Project lead.

Add or change your next-gen service project's default assignee

When requests are created in your project, you can set a default assignee. This is useful for open projects where everyone on the site can report tasks to your project.

The default assignee is typically a team member who prioritizes or validates that reported requests are meant for their team and distributes these tasks to their team members accordingly. By default, they receive a notification when someone creates a request in the project.

If you’re not able to change the default assignee, then check if you’ve enabled Allow unassigned issue under system Jira’s general configuration. Learn more about configuring Jira application settings.


To change your project's default assignee:


  1. From your project's sidebar, select Project settings > Details.
  2. In the Default assignee field, nominate your project's default assignee.
  3. Select Save.


The default assignee can only be either Unassigned, or the Project lead. If you want a specific person to be the default assignee, you'll need to change the Project lead.

Trash for next-gen software project

  • Jira administrators with the Administer Jira global permission or any user with the Administer the project permission can move projects to trash.
  • Only Jira administrators can access trash and restore or permanently delete projects from trash.

As Jira admins or project leads, you can get rid of projects that you don't need by moving them to trash. The projects along with its issues, components, attachments, and versions will be available in trash for 60 days after which they will be permanently deleted.

From the trash, Jira admins can: 

  • View when a project was moved to trash
  • View the user who moved the project to trash
  • View when a project will be permanently deleted
  • Restore a project that was moved to trash
  • Permanently delete a project

Move a project to trash

To move a project to trash: 

  1. Choose Projects > View all projects.
  2. Find your next-gen software project and select ••• > Move to trash. A confirmation dialog appears.
  3. Click Move.

Alternatively, you can: 

  1. Choose Settings () > Projects.
  2. Select Projects from the sidebar.
  3. Find your next-gen software project and select ••• > Move to trash. A confirmation dialog appears.
  4. Click Move.

You can also:

  1. Choose Settings () > Projects or
    choose Projects > View all projects.
  2. Find your next-gen software project and select ••• > Project settings.
  3. Select Details from the sidebar.
  4. Click ••• > Move to trash. A confirmation dialog appears.
  5. Click Move

Restore a project from trash

When you restore a project, it will appear in directories and its issues will appear in search results.

To restore a project: 

  1. Choose Settings () > Projects.
  2. Select Trash from the sidebar. 
  3. Find your next-gen software project and select ••• > Restore

Delete a project

Once you delete a project, you won't be able to recover it, so make sure you truly want to delete the data associated with your project.

To permanently delete a project: 

  1. Choose Settings () > Projects.
  2. Select Trash from the sidebar. 
  3. Find your next-gen software project and select ••• > Delete permanently.

Delete your next-gen service project

If you delete your service project, only a Jira admin can recover it from a backup or an XML copy (if one exists!). Recovering a deleted service project can be tricky, so make sure you truly want to delete the data associated with your service project.

To delete your next-gen service project:

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