Jira Service Management is getting a new navigation

We’re in the process of rolling out these changes and the documentation may not match your experience. Bear with us while we update it to reflect the new changes. More about navigating the new Jira

Edit your service space details

As a space admin, you can edit your space’s:

  • Name 

  • URL

  • Icon

  • Description

  • Space lead

  • Default assignee.

To edit the space key or category, you must be a Jira admin:

  1. Next to the name of your space in the sidebar, select More actions (•••), then Space settings.

  2. Select Details.

  3. Edit the relevant details and select Save.

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

Change a space key

  • Only organization, site, and Jira admins can edit a space key.

  • We are currently exploring solutions to allow previous space keys to be reused. Review the feature request ticket

Things to consider before changing a space 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 space with a space key that has been used previously. Previous space keys are saved to ensure that any links, filters, and queries using your previous keys continue to work.

  • 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 space key will continue to work; however, link aliases within descriptions will not be updated with the new space 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 space 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 space key, we recommend communicating the change to your users. The new space key will also need to be used to update any links, filters, and queries.

To change your space key:

  1. Next to the name of your space in the sidebar, select More actions (•••), then Space settings.

  2. Select Details.

  3. In the Space key field, enter your desired space key. It must:

    • be at least two characters long

    • start with an uppercase letter and

    • contain only uppercase letters or numbers.

  4. Select Save.

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

Most teams supply an address to documentation about the space, 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 space’s URL:

  1. Next to the name of your space in the sidebar, select More actions (•••), then Space settings.

  2. Select Details.

  3. In the URL field, enter your link.

  4. Select Save.

Add a space description

Admins can view the description in the Summary section of your space’s settings.

To add or edit your space’s description:

  1. Next to the name of your space in the sidebar, select More actions (•••), then Space settings.

  2. Select Details.

  3. In the Description field, enter a brief, detailed explanation of the space.

  4. Select Save.

Change your space’s type

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

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

Read more about space types and what makes them different

Editing a space’s category

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

Change your space’s icon

Icons help give a face to your space’s name. They appear in the sidebar and in your site's list of all spaces.

To change your space’s icon:

  1. Next to the name of your space in the sidebar, select More actions (•••), then Space settings.

  2. Select Details.

  3. Select Change icon under your current icon.

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

  5. Select Select, then Save.

Change the space lead

A space’s lead is usually the space admin, who controls and manages a space’s settings.

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

To change your space’s lead:

  1. Next to the name of your space in the sidebar, select More actions (•••), then Space settings.

  2. Select Details.

  3. In the Space lead field, set a new person to lead the space.

  4. Select Save.

Add or change your space’s default assignee

When work items are created in your space, you can set a default assignee. This is useful for open spaces where everyone on the site can report tasks to your space.

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

To change your space’s default assignee:

  1. Next to the name of your space in the sidebar, select More actions (•••), then Space settings.

  2. Select Details.

  3. In the Default assignee field, nominate your space’s default assignee.

  4. Select Save.

Note that the default assignee can only be either Unassigned or the Space lead. If you want a specific person to be the default assignee, you'll need to change the Space lead (described above).

Still need help?

The Atlassian Community is here for you.