logoBack to App page
Issue Templates for Jira
Cloud Data Center
Documentation
FAQ
Release notes
Migration to Cloud
Issue Templates for Jira
Cloud Data Center
Documentation
FAQ
Release notes
Migration to Cloud
Last updated Apr 17, 2024

Repository

This chapter provides information about template repository.

Template repository is a space that stores your templates. You can either create a separate space for your templates or use one of your existing spaces to store them. You can have some work items in your regular Jira space turned into templates just for your team.

Adding a new repository

Note
Adding a new global repository requires Jira admin permissions. You can enable your space as a local repository as a space admin, see Local repository for details.
  1. Navigate to Space Settings > Apps > Issue Templates.
  2. Click Add new repository.
    Issue Templates for Jira - Repository
    Issue Templates for Jira - Repository
  3. Select a space or spaces from the list.
  4. Click Set availability.
    Issue Templates for Jira - Repository
    Issue Templates for Jira - Repository
  5. Select either global or local repository type.
    Issue Templates for Jira - Repository
    Issue Templates for Jira - Repository

Result

Your space has been added to the repository list.

Issue Templates for Jira - Repository
Issue Templates for Jira - Repository

Tip

You can change availability later.

Global repository

Note
Setting a global repository requires Jira admin permissions.

Any space can become a template repository. You can share your templates from a space you work in globally, create a new, separate space for templates, or use templates from multiple repositories.

Global templates can be used by anyone within your Jira instance (unless specified otherwise in visibility rules - also requires Browse space permission) for multiple spaces.

Issue Templates for Jira - Repository
Issue Templates for Jira - Repository

Result

Your space has now become a global repository and templates stored in the space can be shared between multiple spacess.

Local repository

You can have templates enabled just for your space. This space will serve as a local repository and templates created in it won’t be shared between other spaces.

Enabling template creation for your space

Warning

If you enable your template as a repository work items that you turn into templates will affect your reports.

You should exclude such work items from your reports. You can use JQL - issue TemplateEnabled is Empty OR issueTemplateEnabled = “false”.

See JQL searchers for details. .

  1. Navigate to Space Settings > Apps > Issue Templates

  2. In the General Settings tab enable the toggle - turn the selected space into a template repository and add it to the list in global settings.

    Issue Templates for Jira - Repository
    Issue Templates for Jira - Repository

  3. Set appropriate Permissions whether you want every user of your space to be able to use templates or only selected space roles of your choice.

Tip

See Template configuration for details on configuring and enabling a template. If you can’t enable or edit a template contact your administrator to adjust Visibility.

Result

You can now use Create from template based on the enabled templates in this space.

Changing repository Global <-> Local

Turning a space into a global repository

Note

Before you start, make sure your space is enabled as a template repository, otherwise it won’t appear on the list. You can activate it directly in space configuration or use the Add new repository button.

  1. Go to the Repository tab in Global configuration.
  2. Click the Three dots menu next to your space.
  3. Click Change to global availability.
    Issue Templates for Jira - Repository
    Issue Templates for Jira - Repository
Note

The process is the same if you want to switch a space from global to local. You just select a global space and change the availability to local.

Warning

Changing availability from global to local is a severe change, users working with this repository might lose access to their templates. This change will clear template availability settings and restore default availability. The templates will be only available locally in this space.