App page
Issue Templates for Jira
Cloud Server/Data Center
Issue Templates for Jira

Cloud

Server/Data Center

Documentation
FAQ
Release notes
Migration to Cloud
Last updated Dec 16, 2024

Use cases

This chapter provides use cases - examples how Issue Templates for Jira can be used in practice.

How to benefit from multiple template repositories

Overview - multiple repositories

In this scenario you have several projects in your Jira instance. Most of these projects share similar workflows and can benefit from common templates.

Issue Templates for Jira - How to use multirepo
Issue Templates for Jira - How to use multirepo

There is one project that serves as a storage for templates for multiple software projects (global repository).

Issue Templates for Jira - How to use multirepo
Issue Templates for Jira - How to use multirepo

The Human Resources project wants to have its own templates, however, other projects don’t need to use these templates. This project can be converted into a local repository, so only members of this project are able to use templates stored here.

Issue Templates for Jira - How to use multirepo
Issue Templates for Jira - How to use multirepo
Example

As you can see, there is one template for this project here and some regular issues.

There are two projects at this point that store templates. One designated project for template storage that is set as a global repository, and one regular project that has some issues turned into templates that is set as a local repository.

Issue Templates for Jira - How to use multirepo
Issue Templates for Jira - How to use multirepo

With this kind of configuration you can avoid overfilling template selection and enable specific templates for specific projects.

Issue Templates for Jira - How to use multirepo
Issue Templates for Jira - How to use multirepo
Issue Templates for Jira - How to use multirepo
Issue Templates for Jira - How to use multirepo

Tip

See the section below for more detailed configuration.

Configuration - Multiple repositories

As explained before, such a configuration can be very useful in different scenarios. Here’s an example of such a configuration.

Enable both projects as repositories, one is set as global and one is set as local.

Issue Templates for Jira - How to use multirepo
Issue Templates for Jira - How to use multirepo

Global repository - template storage for multiple projects

  1. Go to project configuration and set General settings accordingly. In this case every user of this project is able to turn issues into templates.
    Issue Templates for Jira - How to use multirepo
    Issue Templates for Jira - How to use multirepo
  2. Manually or automatically enable issues as templates or simply add new templates to this project and set availability.
    Issue Templates for Jira - How to use multirepo
    Issue Templates for Jira - How to use multirepo
  3. Check the list to see your active templates.
    Issue Templates for Jira - How to use multirepo
    Issue Templates for Jira - How to use multirepo
  4. Use an existing scope or create a new one.
    Issue Templates for Jira - How to use multirepo
    Issue Templates for Jira - How to use multirepo

Local repository - template storage for a single/specific project

  1. Go to project configuration and set General settings accordingly. In this case only a selected project role is able to create templates.

    Issue Templates for Jira - How to use multirepo
    Issue Templates for Jira - How to use multirepo

  2. Manually or automatically enable issues as templates or simply add new templates to this project and set availability.

    Issue Templates for Jira - How to use multirepo
    Issue Templates for Jira - How to use multirepo
    Note

    To avoid creating templates uncontrollably, the automatic option is disabled by default. Contact your administrator if you want to have templates enabled automatically.

  3. Create an issue and enable it as a template. You can set a scope and availability for each issue. This example uses dynamic variables.

    Issue Templates for Jira - How to use multirepo
    Issue Templates for Jira - How to use multirepo
    Issue Templates for Jira - How to use multirepo
    Issue Templates for Jira - How to use multirepo

  4. Check the list to see your active templates.

    Issue Templates for Jira - How to use multirepo
    Issue Templates for Jira - How to use multirepo

  5. Use an existing scope or create a new one.

    Issue Templates for Jira - How to use multirepo
    Issue Templates for Jira - How to use multirepo

Automatically creating version and component in different projects

Issue Templates for Jira Cloud offers a feature that will automatically create respective version and component according to the template. For example, a project that stores software templates contains specific versions and components. If you use this template in other projects that don’t have these items, they will be automatically created.

Steps

  1. Create a template that contains a component and/or version.
    Issue Templates for Jira - How to use component and version
    Issue Templates for Jira - How to use component and version
    Issue Templates for Jira - How to use component and version
    Issue Templates for Jira - How to use component and version
  2. Create a new issue from this template.

Result

Your issue has been created based on the template and versions/components were added to this Jira project.

Issue Templates for Jira - How to use component and version
Issue Templates for Jira - How to use component and version

Implementing a new feature (Smart defaults)

In this scenario, a user wants to have a template that would automate the process of implementing a new feature. With smart defaults, the process can automate:

  • filling the starting date
  • setting a deadline
  • setting a reporter and assigning an issue to a specific role or person
  • creating a label for this feature
  • setting a version
Issue Templates for Jira Cloud: Static Variables
Smart defaults use case

In this case, smart defaults are configured as follows:

  1. Start date - set to now, so it will automatically fill the start date as the day it was created. Thanks to smart defaults and static variables, this date will be automatically added to the custom field and description. In this case it corresponds with a custom field #10015, but it can be any custom field of a date picker type.
    Tip

    See Atlassian support for details on checking the ID of a custom field.

  2. Due date will set a deadline for the process. In this case, it will add 10 business days to the start date using smart dates .
  3. A person who creates an issue will be assigned as a reporter.
  4. The issue will be assigned to a specific role, in this case the project lead.
  5. A label will be automatically created that corresponds with the name of the feature. The label refers to the value you have set in the dynamic variable.
  6. You can set the version here. The fix version field is based on the value set as the dynamic variable.

The feature name will be automatically applied to the referred fields, such as the summary, new feature idea in the description and the label in this case.

Once the template is configured, the user can navigate to the create from template option to use it.

You will be asked to fill in the feature name, description (user story), and the version.

Issue Templates for Jira Cloud: Static Variables
Smart defaults use case

Result

The output looks like this:

Issue Templates for Jira Cloud: Static Variables
Smart defaults use case

Preparing a timeline for a complex task with multiple steps (Smart defaults)

In this scenario, a user wants to plan an event and add steps in form of a timeline. With smart defaults you can offset dates easily, as well as copy values from parent and linked issues. An epic is created that corresponds with planning steps. Steps are added as stories and an epic for a corresponding process that happens simultaneously is linked.

Issue Templates for Jira Cloud: Static Variables
Smart defaults use case

Child issues are configured using smart defaults to shift one week forward and copy components and the assignee from the parent.

Issue Templates for Jira Cloud: Static Variables
Smart defaults use case

The linked epic is also configured to copy the due date from the main task and shift it in time.

Issue Templates for Jira Cloud: Static Variables
Smart defaults use case

Result

Both epics have been created and child issues with set values have been applied.

Issue Templates for Jira Cloud: Static Variables
Smart defaults use case

Child issues copied the assignee, components, and shifted the date as configured.

Issue Templates for Jira Cloud: Static Variables
Smart defaults use case
Issue Templates for Jira Cloud: Static Variables
Smart defaults use case

Due date of the linked epic has also been shifted.

Issue Templates for Jira Cloud: Static Variables
Smart defaults use case
Tip
With this feature you can automatically set timelines for your processes and copy necessary values from linked issues.

Linking an epic with smart defaults

You can configure an epic link or a parent in smart defaults so that it will link to an already-existing epic. This way templates will automatically link to the specified epic in this project or another.

See How to use smart defaults for details.

Issue Templates for Jira Cloud: Static Variables
Smart defaults use case
Issue Templates for Jira Cloud: Static Variables
Smart defaults use case

Creating an onboarding template with a checklist

You can prepare a template for onboarding purposes that includes a checklist. In this scenario, a checklist corresponds with necessary access levels for a new employee.