User Guide
Quick Start
Get your first template working in 3 steps:
Open the plugin — click Issue Templates in the Jira left sidebar (under "Your apps")
Create a template — click + Add template, fill in the name, summary, and description, then click Save template
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
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:
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.
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, bold, italic, 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.
Steps to assign:
In the Search projects field, type and select a project
In the Select issue type dropdown, choose the issue type (e.g., Bug, Story, Task)
Click + Add to add the combination to the list
Repeat steps 1–3 for additional project/issue type combinations
Click Save settings to confirm
Each row in the assignment list shows:
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.
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.
5. Edit a Template
In the template list, click the
···menu on the row you want to editSelect Edit Template
Update the Template Name, Issue Summary, or Description
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.
Click the
···menu on the template you want to copySelect Duplicate Template
A new template is created with the same Summary and Description content
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
Click
···→ Delete on the template rowConfirm 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 |
|---|---|
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 |
|---|---|
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:
The template is assigned to the exact project and issue type you are creating
The plugin is installed and enabled in Jira
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 |
|---|---|
Create a template | + Add template → Fill in name, summary, description → Save template |
Assign template to project |
|
Edit a template |
|
Duplicate a template |
|
Delete a template |
|
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 |