Shared Dashboard Gadget

What are Shared Dashboards?

 

Custom Charts Shared Dashboards allow you to share entire dashboards of your favorite charts with internal and external users on Jira Cloud.

With Shared Dashboards you can display Custom Charts in the Jira Service Management portal, or internally like a wallboard.

 

Creating a Shared Dashboard

  1. While editing your dashboard, click Add gadget

  2. In the gadget search bar, search for Shared Dashboard. Click to Add the “Custom Charts Shared Dashboard” gadget

  3. Configure the way you’d like your Shared Dashboard to appear:

In the Live Preview

In the Additional Settings and Link Access Permissions

In the Live Preview

In the Additional Settings and Link Access Permissions

  • All Custom Charts gadgets that you’ve already added to your Jira dashboard will be visible here. Drag and drop the various gadgets to reposition them on your Shared Dashboard

  • You can use the Trashcan icon to the right of the name of each gadget to remove the ones you do not want to include in your Shared Dashboard

  1. Title (Required): This will be populated by default with the Jira dashboard name, and can be edited

  2. Layout: adjust the column layout for your Shared Dashboard

  3. Theme: choose light mode or dark mode

  4. Link Access Permissions: this setting controls who can access the link to your Shared Dashboard. See below for more details on Link Access Permissions

JSM Portal and Shared Dashboards

When JSM Portal users is selected under Link Access permissions, Shared Dashboards in the portal are available from the Account dropdown, under My Dashboards. Customers will be able to see any dashboards that have been made available to them.

This sharing setting is disabled by default, and must be enabled by a Jira Admin before users can display Shared Dashboards in the portal.

Step 1: Enable Shared Dashboards for the JSM Portal

To enable this, you must be a Jira Admin.

  1. Navigate to the Custom Charts - Shared Dashboard Admin Settings. You can do this by either :

    1. Editing your Shared Dashboard gadget and clicking Admin settings in the bottom right corner of the gadget

    2. In the Jira navigation, clicking Apps → Manage your Apps → Custom Charts - Shared Dashboard - Settings

  2. In the Shared Dashboard Settings, on the Link Options tab, navigate to the JSM Portal - Access restrictions section. Click the toggle on the right to enable the link option. You will know it’s enabled once the toggle turns green with a checkmark

  3. You have successfully enabled the JSM Portal link option!

    1. You can use the Users and Groups selectors to add specific Jira users and/or Jira groups you want to give access to creating Shared Dashboard links for the JSM Portal. Users listed here are the only ones who can set the Link Access Permissions to Shared Dashboards.

NOTE: The Users and Groups selectors are not for granting access to the Shared Dashboard links in the Portal. They are meant to grant more specific Jira Users and/or Jira Groups access to creating Shared Dashboard links for the JSM Portal. Giving visibility to the link in the Portal happens directly in the Shared Dashboards gadget editor. Navigate to Step 2 of this section to find out more.

 

Step 2: Configure Shared Dashboard gadgets for the portal

 

When JSM Portal users is selected under Link Access permissions, Shared Dashboards in the portal are available from the Account dropdown, under My Dashboards. Customers will be able to see any dashboards that have been made available to them.

To grant specific permissions to the link in the Portal, while editing your Shared Dashboard gadget:

  1. On the right side of the gadget editor, under Link Access Permissions, select the radio button next to JSM Portal - Access restrictions.

    1. JSM Project (required) - In the dropdown, select the particular JSM project(s) where the Shared Dashboard link should appear in the portal. This makes the Shared Dashboard link available to all Customers of that service desk

    2. Organization (optional) - If you’d like to give a subset of customers access to the Shared Dashboard link, in the dropdown, select the particular Organization(s) that house those customers

    3. Portal user (optional) - If you’d like to give specific portal user(s) access to the Shared Dashboard link only, select them from this dropdown

  1. Save the Shared Dashboard gadget.

For more information on each Link Access Permission, see the section below.

Viewing Shared Dashboards

Link Access Permission setting - “Only users with access to this Jira dashboard”

In the Link Access Permission settings, if Only users with access to this Jira dashboard is selected, the Shared Dashboard link will not appear in the JSM Portal. It can instead be accessed directly from the Jira Dashboard appear as a wallboard. Users can access this following these steps:

  1. Navigate to the Jira Dashboard where the Shared Dashboard gadget lives

  2. Navigate to the specific Shared Dashboard gadget

  3. On the default tab, click the title of the Shared Dashboard - it will appear as a link. The Shared Dashboard will open as a wallboard in a new tab

    1. You can also provide a direct link to the Shared Dashboard by clicking “Copy link” on the default tab

Link Access Permissions setting - “JSM Portal - Access Restrictions”

In the Link Access Permission settings, if JSM Portal - Access Restrictions is selected, the Shared Dashboard link will appear in the JSM Portal. Users can access this by following these steps:

  1. Navigate to the JSM Portal

  2. Click their user profile icon in the top right corner of the Portal

  3. Click My Dashboards. It will open up as a pop-up in the Portal

Shared Dashboards Data Restrictions

Shared Dashboard Owner

When a Shared Dashboard is created, all of the issues in the charts are loaded with the permissions of the Shared Dashboard owner. This user is the last person to save the Shared Dashboard gadget.

This user is also the only one who can edit Custom Charts that are part of the Shared Dashboard. For additional details on changing the Shared Dashboard owner, navigate here.

 

Viewing the Shared Dashboards Gadget on a Dashboard

When users come to the Dashboard, they can view the Shared Dashboard gadget and see the details of some of its settings, as depicted in the screenshot below.

There are 4 tabs users can click through on the Shared Dashboard gadget when viewing it:

1 - Shared Dashboard tab (default tab): Users can navigate here to view the Shared Dashboard ( the link “Shared Dashboard Sample” in the screenshot above), and, grab the direct link to the Shared Dashboard to send out to users (“Copy link” button)

2 - Link Access permissions: Users can navigate here to see details around the viewing permissions for the Shared Dashboard

3 - Shared dashboard user: Users can navigate here to see who the Shared Dashboard owner is and learn more information around the restriction

4 - What is this?: Users can navigate here to see the Splash Screen for the gadget, which acts as a helpful guide for users new to Shared Dashboards

Active : Users can see if the link to the Shared Dashboard is active and able to be shared with others

Shared Dashboards Administration and Link Access Permissions

Enabling Shared Dashboards

If you are a Jira admin, you can access Custom Charts admin settings. The admin settings let users enable/disable specific features of Custom Charts, including Shared Dashboards. To enable the feature:

  1. Navigate to the Custom Charts - Settings by:

    1. Editing any Custom Charts gadget and clicking Admin settings in the bottom right corner of the gadget

    2. In the Jira header, clicking Apps → Manage your Apps → Custom Charts - Settings

  2. Click the Features tab

  3. Navigate to the Shared Dashboards section and ensure the toggle is turned on (green with a checkmark)

Link Options

 

Link Access Permissions Details

Link List

Clicking the Link List tab in the Shared Dashboard - Settings gives admins access to a list of all Shared Dashboard gadgets that exist in the Jira instance. The columns in the list provide the following details:

  1. Jira Dashboard - Displays the name of the Jira Dashboard that particular Shared Dashboard gadget lives on

  2. Jira Dashboard Owner - Displays the name of the owner of the Jira Dashboard that particular Shared Dashboard gadget lives on

  3. Shared Dashboard - Displays the title of the particular Shared Dashboard

  4. Shared Dashboard Owner - Displays the owner of the particular Shared Dashboard gadget

  5. Shared with - Displays the Link Access Settings for the particular Shared Dashboard gadget

  6. Status - Displays the status of the particular Shared Dashboard gadget

FAQ