We have a new documentation site. Please go here to see the latest.

Add checklist to new issues (automatically)

Owned by Jack (Hunter) Jaroczynski
Last updated: Jan 28, 2019

Default Checklist (template) is applied automatically to all new issues (issue types) created in a project. 

Default Checklist (template) is defined per project and issue type, which means that each project and issue type can have its own default checklist. 

Hint

You can apply the template from the Automation rule or REST API too. 

 Expand to read more and troubleshoot...

Please note that you cannot combine Default Checklist feature with the "Issue Created" trigger from the Automation plugin. 
The reason is that both solutions depend on Jira "Issue Created" notification, which is sent asynchronously, and we don't know which plugin handles it first. 

"Administer Projects" permission is required to create a default checklist.

Users without required permissions will see "Set default" option disabled with appropriate explanation in a tooltip.

Please note that System Administrators in Jira have access to project administration even if they don't have "Administer Projects" permission. Issue Checklist respects that and allows system administrators to work with all the templates. 

Read more about template permissions.

Please note that cloned checklist takes precedence over the default checklist. It means that for issues cloned with a non-empty checklist, the default template is not applied.

Every Jira workflow contains an "Issue Created" post-function by default. It is required by default checklist to work correctly and you should not remove it. 

Defining a default checklist (template)

In order to create a default checklist (template), please follow the steps:

  • Open an existing issue in a project that you want to define a default checklist for.
    Next, on the issue page, find the Checklist panel and open Manage Templates dialog:
    • Click three dots "..." menu button.
    • Click "Manage Templates" option.



  • Alternatively, navigate to Checklist Templates page in project sidebar:

    Most of the screenshots below were taken from inside the Manage Templates dialog but the process is identical on the Checklist Templates page.

  • Click "Set default" for the selected template.

    If the templates dialog/page is empty, please create a template first.

  • Select issue types that will get the checklist applied when created or select "All issue types" option to make the checklist default for all issue types in the project.



    Click "Save" button to close the dialog and store default template settings.

  • At this stage, every issue created in the selected project will get the checklist applied automatically, according to the settings above.