Checkhive

Checkhive – Checklists for Jira: User guide

Getting started

  1. Install Checkhive from the Atlassian Marketplace (Jira admin).
  2. Open any issue and choose Apps → Checkhive (the panel stays on that issue from then on). When a template is imported automatically, the panel appears by itself.
  3. Type an item in the box and press Enter. Start a line with # for a header or ## for a sub-header. Paste several lines to add them all at once.

Working with items

Headers and tabs

Text mode

Click ✎ to edit the whole checklist as text.

Syntax Meaning
# Title / ## Title Header / sub-header (a # header is a tab in tab view)
- item To do
+ item Done
~ item In progress
x item Skipped
-! item Mandatory item
- [Blocked] item Custom status by name
[priority="High"][dueDate="2026-09-13"][assignee="<accountId>"] Attributes right after the marker
> text Details line for the item above
**bold**, _italic_, `code`, [text](https://…), :tada: Formatting

Templates

Automation

In a template's settings:

Workflow validator (mandatory items)

Jira only blocks a transition when its workflow contains the Checkhive validator, and only a Jira admin can add it.

  1. One click (recommended): Jira admin opens Project settings → Apps → Checkhive → Mandatory items, which shows whether the project is protected, and clicks Enforce in workflow. Checkhive adds the validator to every transition into a Done status of that project's workflows. Remove the rule takes it off again. If a workflow is shared with other projects, the page says so; the rule then applies to those projects too.
  2. By hand: Jira settings → Work items → Workflows → edit the workflow → select a transition → Validators → Add → "Checkhive - mandatory items completed".
  3. The transition is then blocked until every mandatory item is Done or Skipped, with a message listing the open items.
  4. To let every transition through in one project without changing the workflow, untick Enforce mandatory items in this project on the same page.

Project settings (project admins)

Project settings → Apps → Checkhive, or ⋯ → Manage checklist statuses in any issue:

Boards, filters and JQL

The Checkhive progress field holds done/total (e.g. 3/8). Add it to board cards or filter columns, or search with JQL, e.g. "Checkhive progress" is not EMPTY.

History

Open Checkhive history under the checklist to see who changed what and when, including automation.

Limits

Licence

Without an active licence, checklists stay visible but cannot be changed, automation pauses and the validator does not block transitions. A banner tells admins to renew the app in Manage apps.

Privacy

Checkhive stores checklist content and Atlassian account ids only (no names or emails), inside Atlassian's cloud. When an Atlassian account is closed, its id is removed automatically.

Support

Email support@checkhive.app or see the support page.