/
Multiple checklists

Multiple checklists

Multiple Checklists feature is supported starting from version v7.5.0.

Better organise checklist with separate tabs. Track each checklist tabs' progress within the same issue to gain clear progress visibility. Automate checklist tabs based on the workflow transitions or other triggers to streamline the process⚡️

📢 Your feedback helps! Let us know how can we improve Multiple Checklists. Give feedback

👤 JIRA PERMISSION REQUIRED: Admin rights are needed to create and manage checklist tabs.

Contents👇🏼

Overview & Use cases

Better organize your checklists by splitting them into separate tabs. Track and automate them with ease for improved task management. Find out key highlights and primary use cases below.

📂 Clear task organization: Divide checklist into separate tabs for improved structure and focus.
📊 Individual progress: Track progress of each checklist tab separately for better clarity and visibility.
⚙️ Workflow automation: Automatically add checklist tabs based on issue type, workflow transitions, or other triggers.
👥 Cross-team collaboration: Add different checklist tabs to team members or departments for efficient collaborative work.
📋 Checklist Templates integration: Assign templates to individual tabs for streamlined processes.

Group 41747-20250106-124534.png

Use cases:

🗂️ Split checklist for different tasks or teams

Marketing, sales, and support can work together on a product launch within a single issue. Assign each department its own checklist or checklist template to keep everything organized and maintain clear progress tracking without mixing tasks.

📄 Add separate tabs based on the issue type

Apply “Definition of Done” or “Definition of Ready” tabs to specific issue types (e.g., Story), so relevant checklists automatically appear where needed.

⚙️ Add separate tabs trough the workflow transition

For required approvals or reviews (like Legal or Security checks), create dedicated checklist tabs per status. This ensures all steps are completed before the issue moves forward.

🚫 Block the transition of the ticket if the separate checklist is not done planned

Prevent the issue from transitioning unless certain checklist tabs are finished. This keeps critical requirements from being skipped.

How it works

Create a new tab

  1. Go to Administration Manage Apps Smart Checklist Settings Checklist Tabs.

  2. Click “+ Create Tab” button to create a new tab.

    image-20250103-095505.png

     

  3. A new tab with “New Tab” title will be automatically created and assigned to All projects.

Assign a tab to the project

You can assign (or unassign) the tab to the project(s) to control the tab's availability for projects.

  1. Navigate to AdministrationManage AppsSmart ChecklistSettingsChecklist Tabs.

  2. Select the tab you want to assign to the project.

  3. In the Share Tab Between Projects field, select the desired projects from the dropdown:

    1. All projects (default): The tab will be available in all projects, including newly created ones.

    2. Single or Multiple project: Assign the tab to one specific or several projects.

To unassign a tab from the project, deselect the checkbox for the desired project(s).

Assign a tab to the issue type

You can assign a checklist tab to an issue type to add the tab to the checklist by default for all issues of the specific type. The list of issue types displayed for each tab will depend on the projects you assigned the tab to.

  1. Navigate to AdministrationManage AppsSmart ChecklistSettingsChecklist Tabs.

  2. Click on the tab you want to assign to the issue type.

  3. Choose one of the following assignment methods:

  • Quick Assign to All Issue Types: Turn on the toggle to assign the tab to all issue types.

  • Assign to Specific Issue Types: Mark the checkboxes for specific types (e.g., Bug, Story, Epic). The tab will then only appear on those selected issue types.

To unassign the checklist tab from an issue type, deselect the relevant issue types or turn off the Quick Assign toggle.

Delete a tab

You can delete the checklist tab if tab is not used anymore.

  1. Navigate to AdministrationManage AppsSmart ChecklistSettingsChecklist Tabs.

  2. Click on the tab you want to delete.

  3. Click on the “Bin” button.

     

  4. When the confirmation pop-up appears, choose one of the following:

    • Delete the tab and move existing checklist items to the default tab

    • Delete the tab along with existing checklist items

  1. Click Delete tab button to confirm.

Default Checklist tab

The Default Checklist tab is a dedicated space for items not associated with any admin-created tabs. It appears alongside other tabs in the checklist.

  • Conditional Visibility: It only appears if at least one additional tab is created. If there are no additional tabs, the checklist remains a single list (the default behavior).

  • Positioning: When multiple tabs exist, the Default Checklist tab always appears first in the issue view.

Assign a checklist template to a tab

The Multiple Checklists functionality allows you to assign specific checklist templates to individual tabs, ensuring your team always has clear to-do items aligned with consistent standards.

Assign a checklist template to a tab in Global Settings:

  1. Navigate to Templates Settings: Go to Administration → Manage Apps → Smart Checklist → Settings → Templates.

  2. Select a checklist template you want to assign to the tab.

  3. Add/Edit Default Template Conditions:

    1. Select the Trigger

    2. Add the Condition

    3. Select the Issue Type for Field

    4. Select Issue types for the Conditions and Value fields.

    5. Select the available checklist tab in the Assign to a Checklist Tab field.

Alternatively, you can create a new tab by simply typing the desired tab name. The new tab will be configured with the Projects and Issue

Types scope defined in the template's conditions.

 

Assign a checklist template to a tab on the Project Level (only for project templates):

  1. Navigate to the Project Templates Settings: Go to any Issue → Smart Checklist menu → Manage Templates.

  2. Expand the checklist template you want to assign to a tab.

  3. In the right panel:

    • Select the Issue Type where this template applies.

    • Choose the Tab where the template should be imported by default.

Checklist tabs on the Issue view

The Multiple Checklists feature provides an intuitive way to organize checklist items on the Issue view. Tabs will appear either based on configurations set in Global Settings (for selected projects and issue types) or according to the checklist tabs setup in Automation for Jira.

Progress bar and tab menu

Each tab comes with its own progress bar and a separate menu with additional options:

  • Clear Checklist: Delete all checklist items in the tab.

  • Import from a Template: Populate the tab with a predefined checklist template.

  • Save as a Template: Save the checklist from the tab as a reusable template.

Full-screen editor

You can easily edit checklists across tabs using the Full-Screen Editor.

  • Click the Pen icon to open the editor.

  • All tabs will be displayed at the top of the editor, allowing you to switch between tabs and edit their contents seamlessly.

Automate checklist tabs via Automation for Jira

Automatically add tabs to the checklist or add checklist items to the specific tab based on your custom triggers via Automation for Jira⚡️

Read more here:

Feature Compatibility

The following Smart Checklist features are supported when using Multiple Checklists:

Feature

Description

Feature

Description

https://railsware.atlassian.net/wiki/spaces/CHKSDC/pages/2283176020

Searches for checklist items through all tabs.

Dashboard Gadget

Displays checklist items assigned to a user from all tabs.

https://railsware.atlassian.net/wiki/spaces/CHKSDC/pages/4068835364

Sends notifications for checklist updates or user mentions from all tabs.

https://railsware.atlassian.net/wiki/spaces/CHKSDC/pages/3874684931

Tracks history events for checklist changes across all tabs.

https://railsware.atlassian.net/wiki/spaces/CHKSDC/pages/2350088442

Allows adding checklist tabs or items via automation. If an existing automation rule uses the com.railsware.SmartChecklist.checklist entity property, changes will apply to the Default Checklist Tab. To apply actions to other tabs, specify the tab ID in the entity property.

https://railsware.atlassian.net/wiki/spaces/CHKSDC/pages/2340749561

Validates the completion of all checklist items across all tabs before transitioning an issue.

Validate Mandatory Items Completion before Transition

Validates the completion of mandatory checklist items across all tabs before transitioning an issue.

https://railsware.atlassian.net/wiki/spaces/CHKSDC/pages/3675979777

Displays checklist tabs and their content on the Customer Portal.

https://railsware.atlassian.net/wiki/spaces/CHKSDC/pages/2350350546

Exports checklist items from all tabs to a CSV file.

Known limitations

The following Smart Checklist features currently have limited functionality when using Multiple Checklists:

Feature

Limitation

Feature

Limitation

https://railsware.atlassian.net/wiki/spaces/CHKSDC/pages/2284093477

For issues with multiple checklist tabs, changes can be applied only to the Default Checklist tab.

https://railsware.atlassian.net/wiki/spaces/CHKSDC/pages/2350350380

For issues with multiple checklist tabs, only the data from the Default Checklist tab can be cloned.

https://railsware.atlassian.net/wiki/spaces/CHKSDC/pages/4086923268

For issues with multiple checklist tabs, templates can be imported only to the Default Checklist tab.

https://railsware.atlassian.net/wiki/x/C4A6UQ

For issues with multiple checklist tabs, the content can be updated only for the Default Checklist tab.

https://railsware.atlassian.net/wiki/x/BgAxjg

For issues with multiple checklist tabs, the content can be imported only to the Default Checklist tab.

https://railsware.atlassian.net/wiki/spaces/CHKSDC/pages/3238854657

https://railsware.atlassian.net/wiki/spaces/CHKSDC/pages/2352873485

For issues with multiple checklist tabs, the content can be updated only for the Default Checklist tab.

 

Related content