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

...

To create a Shared Dashboard, simply create your dashboard as your normally would with Custom Charts gadgets. Once you’ve configured your charts, you can add a Custom Charts - Shared Dashboard gadget to the dashboard, and arrange the gadgets and select your sharing options.

In the Shared Dashboard gadget, you will be able to select from all Custom Charts gadgets on the Jira dashboard. Custom Charts without a title will appear as the Chart ID.

...

Image Removed

Once you’ve added the Custom Charts you want to be part of this dashboard, you can drag and drop to arrange them, change the layout, title, and default theme (light or dark mode).

...

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
Image Added	Image Added
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	Title (Required): This will be populated by default with the Jira dashboard name, and can be edited Layout: adjust the column layout for your Shared Dashboard Theme: choose light mode or dark mode 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

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. Image Added

   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.

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

2. Image Added

1. Save the Shared Dashboard gadget.

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