Eriksen Labs Support
Documentation

Getting started

v2.15.02 min readUpdated

Get started, in the app. After installing, the Get started button in Manage apps opens the app's page, which shows two steps at the top: add a template (three examples in one click, your own, or Save as template), then create a work item from it on the project's Templates page. Each step ticks itself once it has really happened, and the steps go away after the first work item made from a template, or sooner with Hide these steps. A project's settings page shows the same steps for that project. Everything below is the long version.

Installing the app changes nothing in the Create dialog. Until a template is made the default for an issue type, the app only adds its pages and its daily check. The pages are a Templates page in each project, the same gallery under Apps, Save as template in each issue's ••• menu, and the pages where templates are managed. The daily check looks at your templates once there are any; see The daily check.

Templates are managed in two places:

  • Jira settings → Apps → Issue Templates & Create Defaults — every template on the site. Only Jira administrators can open it.
  • Project settings → Templates — the templates used in that project. Project administrators manage their own project's templates here without needing a Jira administrator.

Example templates in one step. On either page, Add example templates adds three to a project: a bug report, a task that creates its sub-tasks, and a release epic that creates its stories, tasks and sub-tasks. They are built from the project's own work types, so a project without a Bug type gets no bug report, and an example the project already has is skipped. They are ordinary templates: edit or delete them like any other. On the Jira settings page, choose the project first.

A first template of your own:

  • Choose New template. Give it a name, choose the projects it can be used in (on a project's settings page it is for that project), and the issue types it is for.
  • Under Default for these issue types, choose the issue types whose Create dialog should name this template. Leave it empty for a template people only pick from the Templates page.
  • Fill in what new issues should start with, and choose Save template. The Create dialog in those projects is updated as you save.
  • Try it: open the project's Templates page (a tab or a sidebar entry, depending on the project) and press Create on the template. Jira's Create dialog opens with it filled in. Opening Create in Jira with a default's issue type shows the line naming the default under Summary.
  • Under Will every template work?, press Check now. It tells you whether each template works in every project it is for.

The quickest start is often an issue you already like. Open it, choose Save as template from its ••• menu, and tick the box to make it the default for that issue type. See Save as template.