How to Share Dashboard Folders

Owned by TZR
Last updated: Aug 06, 2022
2 min read
  1. Log in as an administrator into Jira
  2. Go to Manage Add-ons to Configure Dashboard Folders for Jira, or use the shortcut 'g'+'g' and type in "Dashboard Folders"
  3. Admin will see the Dashboard Folders listing page
  4. Click on the "Edit Folder Permission" button (the button will only appear if there are Folders created – see How to Create and Edit Dashboard Folders)
  5. Select the Permission Type:
    1. Private: Folder will not be shared to any user, only administrators can see it (default setting)
    2. Public: Folder will be visible to everyone, including user's not logged in
    3. Logged in Users: Folder will be visible to all logged in users
    4. Shared to Group/Project: Folder will be visible to the specified Group(s) / Project Role(s)
  6. Select the Folder on the left to apply the "Selected Permission(s)" to the Folder
  7. Click on the "Update Permission" button to update the "Selected Permission(s)" to the targeted Folder
  8. Click on "Save Permission" to save the sharing permission on the selected Folders


Cascading Permission

The Folder permission is governed by the parent Folders.

I.e. if a user does not have permission to see the top folder, then all subsequent folders nested inside this top folder will not be visible to the user

Folder Permission

Folder Permission ≠ Dashboard Permission

The user might have permission to see the Folder (and it's encapsulated Dashboard links), but the Dashboard's own permission will still be adhered to

To ensure that the users can see the Dashboard normally, ensure that:

  • Dashboard itself is shared to the user
  • Filters used by the Gadgets is shared to the user
  • User has Browse Permission to the Project

Public Permission

The Public permission set to the Folder only allows the anonymous users to see the Dashboard links from the top navigation bar, but anonymous users might still be unable to view the Dashboard.

To allow anonymous to view the Dashboard, ensure that:

  • Dashboard itself is shared to "Everyone"
  • Filters used by the Gadgets is shared to "Everyone"
  • Gadget supports not logged in access
  • Project itself has Browse Permission set to Group: "Anyone"