Custom Jira Charts for Confluence

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

Jump to a Topic

What is the Issue List macro?

Issue List is a new Custom Charts macro that allows users to generate a list of Jira issues on their Confluence page.

Adding the Issue List Macro to a Page

Custom Charts Issue List is a separate macro from the Custom Charts macro and the Custom Charts Simple Search macro. To add it to your page:

  1. Edit your Confluence page by typing “e” on your keyboard, or, by clicking the pencil icon at the top of your Confluence page

  2. Type “/” on your keyboard or click the + dropdown in the page header and search for Custom Charts. Select Custom Jira Charts - Issue List

  3. In the pop-up, adjust the following settings to customize the Issue List:

    1. Source: Controls the Jira issues that appear in the Issue List

    2. Columns: Controls the fields that appear for each Jira issue in the Issue List. Fields will appear as separate columns on the Issue List (similar to their appearance in the Issue Navigator in Jira)

      1. Fields will be selected by default, but you can add additional fields by clicking + Add Another Field at the bottom of the list of fields

Setting up Issue List

To see how your configuration will look once the macro is published, use the Live Preview on the left side of the Editor

Source

The Source controls the Jira issues that appear in the Issue List macro.

  1. Projects: allows you to choose specific Jira project(s) to pull issues in from

  2. Saved filters: allows you to pull in issues based off any Jira filters you’ve already created

  3. Advanced (JQL): allows you to pull in issues based off custom JQL written directly within the macro

  4. Simple Search macro: allows you pull in issues based of criteria set in a Simple Search macro - ⚠ you must have already inserted and customized the Simple Search macro on the page for it to be an available option

Columns

Columns control the fields that appear for each Jira issue in the Issue List. Fields will appear as separate columns on the Issue List (similar to their appearance in the Issue Navigator in Jira). Jira system fields and custom fields can be added, including 3rd party application fields (full list of integrations here).

Adding Fields (Columns)

  1. Once in Edit mode in the macro, navigate to the Columns section on the right. At the bottom of the “Columns” section, click + Add another field

  2. In the “Select field” dropdown, type the name of the Jira field you wish to add. Click the field to add it to your chart and see it in the Live Preview on the left

  3. Click Save, then publish your Confluence page. The field will be added as a new column in the macro.

Removing Fields

  1. Once in Edit mode in the macro, navigate to the Columns section on the right. Find the name of the field you want to remove

  2. To the far right of the field, click the trash can icon

  3. Click Save to lock in your changes

  4. Republish the page and the field no longer appears in the macro

Renaming Fields

  1. Once in Edit mode in the macro, navigate to the Columns section on the right. Find the name of the field you want to rename

  2. To the far right of the field, click the pencil icon and type in the name you want to be shown for the column

  3. Click Save to lock in your changes

  4. Republish the page and the field displays with the new name

Issue List Display Options

 Display Options

Chart options

  • Results per page dropdown: Adjusts the amount of issues that appear on each page of the Issue List macro

Start your 30-day free trial of Custom Charts for Jira from the Atlassian Marketplace or directly on your Jira instance.

What’s on this page?

Get a trial license from the Atlassian Marketplace

  1. Go to the Custom Charts marketplace listing and choose your desired hosting type from the dropdown.

  2. Click the Try it free button and follow Atlassian’s steps in the pop-up window to activate your trial license.

You must have the Jira System Administrators global permission to activate your trial. In case you are not an admin, you can request the app using Atlassian Marketplace’s functionality. Your Jira instance administrator will receive an installation request and enable it for you.

Install directly on your Jira Cloud instance

  1. Login to Jira Cloud as an Administrator

  2. In the top navigation bar, click Apps, Explore more apps

  3. On the Explore Apps page, type Custom Charts for Jira in the Search bar

  4. Click the tile for Custom Charts

  5. On the Custom Charts app page, click Try it free

  6. In the pop-up window, click Start free trial to initialize the installation

Install directly on your Jira Server / Data Center instance

  1. Log into your Jira Cloud as an administrator

  2. In the top right corner of Jira, click the gear icon → Manage apps. This will take you to the Find new apps section of Jira’s Admin settings

  3. In the app search bar, type Custom Charts and hit Enter/Return on your keyboard

  4. In the Custom Charts app section that appears, click Install

  5. In the installation pop-up, click Accept & Install

  • No labels