Issue templates

Create issue templates for repeated issues.

Overview

Use issue templates to write issues faster and guide creators to share information effectively. You can include instructions or specific formatting in the issue description as well as apply certain fields such as labels. It's also possible to set default templates for teams.

Option/Alt C to create issue with template

G then S to go to Settings > Team settings > Templates modal to create or edit templates

Issue creation modal

Ctrl Option/Alt Shift T to apply template

Ctrl Shift T to change teams, then apply template

Configure

Go to team templates settings to create, edit, and set default templates for your team. Templates are team-specific.

Basics

Create templates

Create new templates by navigating to either the workspace template settings or team template settings. Create the issue as you'd like the template to be, then press Save. You'll be prompted to name the template.

When you create a template for the workspace, all teams can use it, but you cannot specify team-specific properties like status for the template.

When you create a template for a team, only that team can use the template.

Edit templates

To edit or delete a template, go to the same page where you created the templates and then hover over the template name in order to show contextual controls. From there, you can edit the the template, rename it, or delete it.

Use templates

The fastest way to create an issue with a template is to use the keyboard shortcut Option/Alt C. This will bring up a list of templates available and then open the selected one in the issue editor. If you don't see the template, then check that you're creating the issue from the right team.

You can also access templates directly from the issue creation modal by clicking on templates next to the team name. Again, if you don't see your template, check that the team is correctly set.

If you've already opened the issue editor, type Cmd/Ctrl K and then search *Apply a template* (you must do this before adding content to the new issue). Click the right-half of the purple create issue button to drop down a list of available issue templates, too.

Default templates

Default templates can be set up on the team template settings page. When you set a default template, it will show up whenever new issues are created under your specific team. You can configure defaults differently for members of your team or people who are not part of your team.

FAQ