Jira Issues module

Due to maintenance, only customers with Refined Sites for JSM whose accounts were created before 20 August 2023 can add Jira projects to their sites. If you have any questions, please contact us.

The Jira Issues module shows a list of issues from one or more Jira projects. It only includes issues that a user is allowed to see according to their Atlassian permissions.

Add this module to a page

  1. Go to a landing page on your site.

  2. Click the Edit page button.

  3. Hover your mouse over the desired location on the page and click the + Add module button that appears.

  4. Click Issues in the left-hand menu.

  5. Select the Jira Issues module.

Edit the title

Simply click the module’s title (heading), to edit it. There are various formatting options, including paragraph/heading styles. Tip: use text variables to make the text dynamic, for example to display the user’s first name.

Edit the settings

  1. Click the module to open its settings menu, which appears on its right-hand side.

  2. Edit the settings, which are divided over multiple tabs:

Module tab

Setting

Description

Setting

Description

Fixed height

By default, all modules adjust their size to their content. To set a fixed height instead, fill in the desired height in pixels.

Jira Issues tab

Setting

Description

Setting

Description

Columns

 

  • Simple lets you choose from the most commonly used columns.

  • Advanced lets you choose more customized columns.

  • Advanced supports the field types string, number, user, date, datetime, and array.

Column titles

Show or hide the titles of each column.

Filter

Filters let you narrow down which issues from your site's Jira projects to show.

  • Simple lets you filter by label, component, project, status and creator.

  • Dynamic lets users only see issues related to them which they can filter themselves.

  • Advanced lets you filter with JQL.

Filter by label
Available when Filter is set to Simple.

Enter a label you use in Jira to include only issues with that label. Add a dash ( - ) in front of a label to exclude its issues. Separate multiple labels with commas.

Filter by component
Available when Filter is set to Basic.

Enter a component you use in Jira to only include the issues that belong to that component. Add a dash ( - ) in front of a component to exclude its issues. Separate multiple components with commas.

Filter by project
Available when Filter is set to Simple.

To include all projects added to your Refined site, leave this field empty.

To show one or more specific projects, enter their Project IDs, separated with commas.

To show dynamic content, enter a text variable:

Filter by status
Available when Filter is set to Simple.

Enter a Jira status to only include issues with that status. Add a dash ( - ) in front of a status to exclude its issues. Separate multiple statuses with commas.

Filter by creator
Available when Filter is set to Simple.

Enter a creator's Account ID to include their issues. Add a dash ( - ) in front of a creator's ID to exclude their issues. Separate multiple IDs with commas.

Order by
Available when Filter is set to Simple.

  • Creation date (descending: newest first)

  • Creation date (ascending: oldest first)

  • Last modified (descending: newest first)

  • Last modified (descending: oldest first)

  • Priority (ascending: lowest first)

  • Priority (descending: highest first)

Number of items

Decide how many items you want to show. Users can browse more items with the arrows at the bottom of the list.

Filter by project
Available when Filter is set to Dynamic.

The module will only show issues related to the user, which they can filter themselves:

  • All issues/Open issues/Closed issues

  • Reported by me/Assigned by me/Watched by me.

Leave the field empty to include all projects added to your Refined site. To include only specific projects, enter one or more Jira Project IDs separated with commas.

Filter with JQL
Available when Filter is set to Advanced.

Make the JQL filter dynamic with text variables.

Find a Project ID

  1. From your project's sidebar, select Project settings > Details.

  2. The Project ID is the number after pid= in the URL.