User Guide

User Guide

Quick Start

Get your first template working in 3 steps:

  1. Open the plugin — click Issue Templates in the Jira left sidebar (under "Your apps")

  2. Create a template — click + Add template, fill in the name, summary, and description, then click Save template

  3. Assign it to a project — in the dialog that appears, select a project and issue type, click + Add, then Save settings

From this point on, whenever anyone creates an issue in that project with the matched issue type, the Summary and Description fields will be automatically pre-filled with your template content.


Interface

Template List Page

图片-20260323-100810.png

 

Element

Description

Element

Description

+ Add template

Opens the Create Template dialog

Name column

Template name (sortable)

Summary column

Preview of the issue summary template text

Description column

Preview of the rich-text description template

Projects column

Shows project + issue type combinations assigned to this template

Action column (···)

Per-template menu: Edit Template, Assign to projects, Duplicate Template, Delete Template

Filter by project

Dropdown to filter the list by a specific project

Search by name

Text search to find templates by name

Expanding the Action menu reveals four per-template operations:

图片-20260323-100835.png

 

Menu Item

Description

Menu Item

Description

Edit Template

Open the template editor to modify name, summary, or description

Assign to projects

Open the project assignment dialog

Duplicate Template

Create an identical copy of the template with a new name

Delete Template

Permanently remove the template and all its assignments


Features

1. Create a Template

Click + Add template to open the Create Template dialog.

图片-20260323-100847.png

 

Field

Required

Description

Field

Required

Description

Template Name

Yes

A descriptive name for the template (e.g., "Bug Report Template")

Issue summary

Yes

The text that will pre-fill the Summary field when creating an issue

Issue description

Yes

Rich-text content that will pre-fill the Description field

Rich-text editor toolbar supports:

  • Headings, bolditalic, strikethrough

  • Bullet lists, numbered lists

  • Links, code blocks, tables, mentions

  • Undo / redo

Click Save template to save. The "Assign to projects" dialog will open automatically after saving.


2. Assign a Template to Projects

After saving a template, the Assign to projects dialog opens. You can also access it later via the ··· menu → Assign to projects.

图片-20260323-100857.png

 

Steps to assign:

  1. In the Search projects field, type and select a project

  2. In the Select issue type dropdown, choose the issue type (e.g., Bug, Story, Task)

  3. Click + Add to add the combination to the list

  4. Repeat steps 1–3 for additional project/issue type combinations

  5. Click Save settings to confirm

Each row in the assignment list shows:

Column

Description

Column

Description

S.No

Row number

Project

The project name and icon

Assigned to

The issue type badge

Action

Delete (🗑) to remove an assignment

Tip: One template can be assigned to multiple projects and issue types simultaneously.


3. Template List After Assignment

Once assignments are saved, the Projects column in the template list shows all linked project + issue type pairs.

图片-20260323-100910.png

 

Each project assignment displays:

  • The project icon and project name

  • The issue type badge (e.g., Story, Bug, Task) in the corresponding color


4. Automatic Pre-fill on Issue Creation

This is the core feature. When a user opens the Create Issue dialog for a project and issue type that has a template assigned, the Summary and Description fields are pre-filled automatically — no extra clicks needed.

图片-20260323-100920.png

 


5. Edit a Template

  1. In the template list, click the ··· menu on the row you want to edit

  2. Select Edit Template

  3. Update the Template Name, Issue Summary, or Description

  4. Click Save template


6. Duplicate a Template

Use Duplicate Template to quickly create a new template based on an existing one — useful when you need similar templates for different projects or issue types.

  1. Click the ··· menu on the template you want to copy

  2. Select Duplicate Template

  3. A new template is created with the same Summary and Description content

  4. Edit the duplicate's name and content as needed, then assign it to the target projects

Tip: Duplicating is faster than creating from scratch when templates share a similar structure (e.g., Bug templates for different teams).


7. Delete a Template

  1. Click ··· → Delete on the template row

  2. Confirm the deletion in the confirmation dialog

Note: Deleting a template removes all its project assignments. Issues that were already created will not be affected.


8. Search and Filter Templates

Use the top-right controls to quickly find templates:

Control

How to use

Control

How to use

Filter by project

Click the dropdown and select a project to show only templates assigned to that project

Search by name

Type any part of a template name to filter the list in real time


Configuration

Template behavior is controlled by the Admin Page settings. See the Admin Page User Guide for details.

Key configuration option:

Setting

Effect

Setting

Effect

Restrict editing to administrators (OFF)

All users can create, edit, and delete templates

Restrict editing to administrators (ON)

Only Jira admins can manage templates; all users can still use them


FAQ

Q: How do I know if auto-fill is working for a project?
A: Open the Create Issue dialog for that project and issue type. If the Summary and Description fields are pre-filled, the template is active. Make sure the template has been saved and correctly assigned to the project + issue type.

Q: Can one project have multiple templates for the same issue type?
A: Each project + issue type combination can only be assigned to one template. If you assign a second template to the same combination, it will replace the previous assignment.

Q: The auto-fill is not appearing when I create an issue. What should I check?
A: Verify the following:

  1. The template is assigned to the exact project and issue type you are creating

  2. The plugin is installed and enabled in Jira

  3. Refresh the page and try again — there may be a brief loading delay on first use

Q: Will the template overwrite content I've already typed?
A: No. The plugin detects if you have manually modified the Summary or Description and will not overwrite your input. The pre-fill only applies when the fields are at their default empty/placeholder state.

Q: Can I use the same template for multiple issue types (e.g., Bug in Project A and Bug in Project B)?
A: Yes. You can add multiple project + issue type combinations in the "Assign to projects" dialog. A single template can serve as many assignments as needed.

Q: Who can see and use the templates when creating issues?
A: All Jira users with access to the relevant project will automatically see the pre-filled content. Viewing and using templates requires no special permissions.


Quick Reference

Task

Steps

Task

Steps

Create a template

+ Add template → Fill in name, summary, description → Save template

Assign template to project

··· → Assign to projects → Select project + issue type → + Add → Save settings

Edit a template

··· → Edit Template → Modify fields → Save template

Duplicate a template

··· → Duplicate Template → Edit the copy → Save template

Delete a template

··· → Delete Template → Confirm

Filter by project

Click "Filter by project" dropdown → Select a project

Search by name

Type in the "Search by name" box

Use a template

Open Create Issue in an assigned project — fields pre-fill automatically