Create, edit, and delete team-managed service spaces

By default, anyone can create team-managed spaces. Out of the box, Jira Service Management gives end users the Create team-managed spaces global permission. Jira admins can prevent users from creating team-managed spaces by managing which groups are granted this permission. Read more about global permissions.

To find out if you can create your own space, choose Spaces in the navigation bar. If you see the Create space option, then you're all set. If not, check with your Jira admin.

Create a team-managed service space

To create a team-managed service space:

1. Select Spaces, then Create space.

2. Select Service Management under Space templates, or Jira Service Management under Apps.

3. Select Use template next to the template you want to use.

4. Select Team-managed.

5. Give your space a name.

6. Choose who can access your space.

7. Select Create.

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

Edit your team-managed service space’s details

In team-managed service spaces, you can edit the following details:

• Icon – helps teams across your Jira site visually identify your service space.

• Name – appears when people in your Jira site search, browse directories or use the space switcher.

• Key – typically the shorthand version of the service space’s name.

• Category – helps larger organizations label and filter spaces in directories.

• Space lead – usually the space administrator for your team-managed service space.

• Default assignee – a person to which all requests created in the space are assigned to.
  
  

To change these details, select Space settings, then Details from your sidebar.

Change your team-managed service space’s icon

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

To change your service space’s icon:

1. From your space’s sidebar, select Space settings, then Details.

2. Under the current icon, select Change icon.

3. Choose a default icon or upload your own.

4. Select Save details.

Change the space key for a team-managed service space

Space keys provide a shorthand for the requests in your service space. Together with a request's sequential number, they form a unique identifier called a “work item key”. This abbreviation is the foundation of how work is tracked and referred to in Jira Service Management. You’ll see work item 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

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 the previous space key. The previous space key will only become available if you delete it from the space it was previously associated with, or if that space is deleted.

• If you change a space key, all work items associated with the space will be updated with the new key.

• If you use Confluence with Jira, the Jira work item macros in Confluence will continue to work. 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 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. You will need to update any links, filters, and queries with the new space key.

Change your space key

To change your team-managed space key:

1. Select Space settings, then Details.

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

   • be at least two characters long

   • start with an uppercase letter

   • contain only uppercase letters or numbers

3. Select Save.

Delete the space key of a team-managed service space

Whenever you change your space key, we automatically save your previous space keys. This ensures any links, filters, and queries using your previous key continue working.

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

• links

• board filters

• dashboard filter gadgets

• JQL queries

Delete a previous space key

To delete a previous space key:

1. Select Space settings, then Details.

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

3. Select Save.

Assign or change your team-managed service space’s category

Space categories help group similar software, service, and business spaces 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. Read more about adding and deleting space categories.

To assign or change your space’s category:

1. From your space’s sidebar, select Space settings, then Details.

2. Under Category, use the dropdown to assign your space a category.

3. Select Save details.

Change your team-managed service space’s lead

The space lead in a team-managed space is usually the space administrator, 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. From your space’s sidebar, select Space settings, then Details.

2. In the Space lead field, set a new person.

3. Select Save.

Add or change your team-managed service space’s default assignee

When requests 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.

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

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

To change your space’s default assignee:

1. From your space’s sidebar, select Space settings, then Details.

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

3. Select Save.
   
   

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.

Trash for team-managed service spaces

As Jira admins or space leads, you can get rid of service spaces that you don't need by moving them to the trash. The service space – along with its requests, queues, automation rules, SLAs, and reports – will be available in the trash for 60 days, after which they will be permanently deleted.

From the trash, Jira admins can: 

• See when a space was moved to trash

• See the user who moved the space to trash

• See when a space will be permanently deleted

• Restore a space that was moved to trash

• Permanently delete a space

Read more about trashing, archiving, restoring, and deleting service spaces.