Displaying Checklist Status on Agile Cards

You can display a Checklist on the JIRA Agile cards by using another custom field that acts as a proxy to the real Checklist. When you install Checklist, two custom field types are added to your installation:

  • Checklist
  • Checklist Read-Only Proxy

The proxy is read-only, reads the Checklist data and displays progress information based on the Checklist's status. You can even customize the proxy to display your own specific text.

To display Checklist status on JIRA Agile cards, perform the following steps:

  1. Create a custom field of the type: Checklist Read-Only Proxy (can be found under the Advanced tab).
  2. Access the custom field and click Configure.

    Default ValueSelect the Checklist that needs to be displayed in on the card.
    Parameters

    Customize how the Checklist should behave and be displayed. Possible parameters are:

    Type

    Allows you to configure the visual style of the Checklist Read-Only Proxy. Possible values are:

    • Checklist. If you want to display the entire Checklist with all of its items but in a read-only manner.
    • Banner. If you want to display an overall status of the Checklist.
    Banner prefix

    Allows you to define the prefix for the banner. Possible values are:

    • None. If you do not want to specify a prefix for the banner.
    • Custom field name. If you want to use the custom field name as the prefix for the banner.
    • Custom. If you want to use a custom prefix for the banner.
    Banner type

    Allows you to specify the type of the banner. Possible values are:

    • Progression. To display the same text as in the Checklist header.
    • Custom. To create your own personalized Checklist status.
      • Completed. To display the personalized Checklist status when the entire Checklist is completed.
      • All mandatory. To display the personalized Checklist status when all the mandatory items are completed.
      • Incomplete. To display the personalized Checklist status when the Checklist is partially completed.
      • Empty. To display the personalized Checklist status when the Checklist as no items.

    While creating your own custom banner, you can use %variables% that provide more information about the Checklist completion. For example:

    results in the string "DoD 100% Completed" if the entire Checklist is completed.

    Available variables are:

    • %CompletedItems%
    • %IncompleteItems%
    • %TotalItems%
    • %PercentCompleted%
    • %PercentIncomplete%
    • %CompletedMandatoryItems%
    • %IncompleteMandatoryItems%
    • %TotalMandatoryItems%
    • %PercentMandatoryCompleted%
    • %PercentMandatoryIncomplete%
    • %CompletedGlobalItems%
    • %IncompleteGlobalItems%
    • %TotalGlobalItems%
    • %PercentGlobalCompleted%
    • %PercentGlobalIncomplete%
    Banner appearance

    Allows you to define the appearance for the banner. Possible values are:

    • Subtle

    • Normal


  3. Go to Board > Configure  > Card layout and select the fields that you want to be displayed in the JIRA Agile card.
  4. Access the Kanban/SCRUM board and click an issue. The system displays the banner on the card according to how it was configured.