Edit your service project details

As a project admin, you can edit your project's:

• Name 

• URL

• Avatar

• Description

• Project lead

• Default assignee

To edit the project key or category, you must be a Jira admin.

To edit a project's details:

1. Open the project you want to change.

2. From your service project, select Project settings, then Details.

3. Edit the relevant details and select Save details.

If you change the name of your project, the new name will automatically update in any filters on your Jira site.

Change a project key

Things to consider before changing a project key

• Before making any significant changes, it’s a good idea to back up your Jira site to ensure important information isn’t lost.

• You won't be able to create a new project with a project key that has been used previously and not yet been deleted. The previous project key will only become available if you delete it from the project it was previously associated with, or if that project is deleted.

• If you use Confluence with Jira, the Jira issue macros in Confluence will continue to work. Please note, if you don't see the change straight away, allow some time for the cache to refresh.

• Links containing the old project key will continue to work; however, link aliases within descriptions will not be updated with the new project key.

  • For example, if you have a link to an issue 'EXAMPLE-1' in the description of an issue, and you change the project key from 'EXAMPLE' to 'DEMO', the alias 'EXAMPLE-1' will not be updated to 'DEMO-1'. But the link will still direct you to DEMO-1.

• After you change a project key, we recommend communicating the change to your users. The new project key will also need to be used to update any links, filters, and queries.

Change your project key

To change your project key:

1. From your service project, select Project settings, then Details.

2. In the Project key field, enter your desired project key. It must:

   • be at least two characters long

   • start with an uppercase letter

   • and, contain only uppercase letters or numbers

3. Select Save.

Delete a previous project key

Whenever you change your project key, we automatically save your previous project keys. This ensures that any links, filters, and queries using your previous key continue to work.

In some cases, you may need to delete a previous project key from its associated project so you can use it for a new project. Deleting a previous project key can impact anything that is still using that project key, including:

• links

• board filters

• dashboard filter gadgets

• JQL queries

Delete a previous project key

To delete a previous project key:

1. From your service project, select Project settings, then Details.

2. In the Previous project keys field, delete the relevant project key.

3. Select Save.

Link to more project details with a project URL

By adding a project URL, you can link team members and viewers to an external site. The URL is displayed in your site’s Projects directory.

Most teams supply an address to documentation about the project, roadmaps or other important content outside of their Jira site. If you use Confluence to collaborate, we recommend adding a link to your team's space.

To change your project's URL:

1. From your service project, select Project settings, then Details.

2. In the URL field, enter your link.

3. Select Save details.

Add a project description

 Administrators can view the description in the Summary section of your project's settings.

To add or edit your project's description:

1. From your service project, select Project settings, then Details.

2. In the Description field, enter a brief, detailed explanation of the project.

3. Select Save details.

Change your project's type

You can't directly change your project's type, but you can create a new project of a different type and move all of the issues into it. For example, if you have Jira, you can move all your issues from a business project to a software project and get finer control over your project's workflow, board settings, and more.

Using a different project type means changing the way your users work in that project.

Read more about project types and what makes them different

Editing a project's category

Your Jira admin may add project categories to help manage projects across your Jira site. Contact a Jira admin to assign your project to one of those categories.

Change your project's avatar

Avatars 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 avatar:

1. From your service project, select Project settings, then Details.

2. In the Avatar field, select your current avatar.

3. Choose from a default icon or upload your own.

4. Select Save details.

Change the project lead

A project's lead 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 service project, select Project settings, then Details.

2. In the Project lead field, set a new person to lead the project.

3. Select Save details.

Add or change your 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.

To change your project's default assignee:

1. From your service project, select Project settings, then Details.

2. In the Default assignee field, nominate your project's default assignee.

3. Select Save details.

Note that 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 (described above).