Editing a project's details

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

  • Name 
  • Key
  • URL
  • Project type
  • Project category
  • Avatar
  • Description
  • Project lead
  • Default assignee

To edit a project's details:

  1. Go to your project's settings.
  2. Select Details.
  3. Make your edits.
  4. 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 your project's key

Some Jira applications will start a background re-index when you save your updated project key. It's best to change a key during a lull on your site to prevent performance issues.

To change your project's key:

  1. Go to your project's settings.
  2. Select Details.
  3. In the Key field, enter your desired key. Your project's key must be at least 2 characters long and contain only uppercase letters.
  4. Select Save details.

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

Link to more project details with a project URL

You can link team members and viewers to an external site by adding a project URL. The project URL displays on the Summary page of some projects, and in the Projects directory of your site.

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. Go to your project's settings.
  2. Select Details.
  3. In the URL field, enter your link.
  4. Select Save details.

Add a project description

Team members and visitors can view a project's description in the Summary page of some projects. And, administrators can view the description in the Summary section of your project settings.

To add or edit your project's description:

  1. Go to your project's settings.
  2. Select Details.
  3. In the Description field, enter a brief, detailed explanation of the project.
  4. Select Save details.

Change your project's type

If you have multiple Jira apps on your site, you can choose to change your project's type. For example, if you have both Jira Core and Jira Software, you can upgrade a business project to a software project and get finer control over your project's workflow, board settings and more.

Changing a project type means changing the way your users work in that project. It's much easier to create a new project than change a project's type after extended use.

Read more about project types and what makes them different.

To change a project's type:

  1. Go to your project's settings.
  2. Select Details.
  3. In the Project type field, select the type of project you want to change to.
  4. Select Save details.

Add or edit your project's category

Your Jira admin may add project categories to help manage projects across your Jira site. If they've added categories, you can assign your project to one of them in your project's details.

To change our project's category:

  1. Go to your project's settings.
  2. Select Details.
  3. In the Category field, select the appropriate category from the drop down.
  4. Select Save details.

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. Go to your project's settings.
  2. Select Details.
  3. In the Avatar field, select your current avatar.
  4. Choose from a default icon or upload your own.
  5. 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 longer-term project.

To change your project's lead:

  1. Go to your project's settings.
  2. Select Details.
  3. In the Project lead field, set a new person to lead the project.
  4. 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 notification when someone creates an issue in the project.

To change your project's default assignee:

  1. Go to your project's settings.
  2. Select Details.
  3. In the Default assignee field, nominate your project's default assignee.
  4. Select Save details.
Last modified on Sep 28, 2017

Was this helpful?

Yes
No
Provide feedback about this article

Not finding the help you need?

Ask the community

Powered by Confluence and Scroll Viewport.