Edit a project's 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. Next to your project's name in the sidebar, select more actions (•••), Project settings, and then Details.
3. Edit the relevant details and select Save.

Changing a project's key

To change your project's key, contact a Jira administrator.

Things to consider before changing a project key

• You won't be able to create a new project with the old project key. The old project key will only be available if you delete the project it was previously associated with.
• If you use Confluence with Jira, the Jira work item 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, as link aliases will not be updated with the new key. For example, if you have a link to a work item 'EXAMPLE-1' in the description of a work item, and you change the project key 'EXAMPLE' to 'DEMO', then the alias 'EXAMPLE-1' will not be updated to 'DEMO-1'. The link will still direct you to DEMO-1.
• After you change a key, we recommend communicating the change to your users. You will need to update board filters, dashboard filter gadgets, and any other global queries 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  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. Next to your project's name in the sidebar, select more actions (•••), Project settings, and then Details.
2. In the URL field, enter your link.
3. Select Save.

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. Next to your project's name in the sidebar, select more actions (•••), Project settings, and then Details.
2. In the Description field, enter a brief, detailed explanation of the project.
3. Select Save.

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 work items into it. For example, if you have both a business project and a software project, you can create a software project and move all of the work items over from a business project to 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 icon

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

1. Next to your project's name in the sidebar, select more actions (•••), Project settings, and then Details.
2. In the Icon field, select Change icon.
3. Choose from a default icon or upload your own.
4. Confirm the icon by hitting Select, then Save.

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. Next to your project's name in the sidebar, select more actions (•••), Project settings, and then Details.
2. In the Project lead field, set a new person to lead the project.
3. Select Save.

Add or change your project's default assignee

When work items 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 work items are meant for their team and distributes these tasks to their team members accordingly. By default, they receive a notification when someone creates a work item in the project.

To change your project's default assignee:

1. Next to your project's name in the sidebar, select more actions (•••), Project settings, and then Details.
2. In the Default assignee field, nominate your project's default assignee.
3. Select Save.

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).