Setting Up the Dashboard Gadget
On this page:
Why would I even want a Dashboard Gadget for Announcements?
The primary reason is twofold:
It presents itself as a central place that pretty much every Jira user visits on a consistent basis, and thus seems like the perfect place to show a list of currently active announcements.
It's the only way to show any kind of content in Jira Cloud. Atlassian imposes several limitations on app developers, and limits where apps can display any data at all. As such, a dashboard gadget is needed to both, show a list of currently active announcements, and to show the announcement dialogs themselves.
note:
Without the dashboard gadget, none of the Announcements would show on the Jira Dashboard, and would only display in the issue details screen, or Service Desk (if applicable).
What functionality does the Dashboard Gadget provide?
Once added to the System Dashboard (or any other Dashboard for that matter), the Announcer Dashboard Gadget is responsible to showing the announcement dialogs that a user should see. Additionally, it automatically shows a list of currently active announcements.
As you can see in the screenshot, we can see the title for each announcement, along with a read status. Any announcements already seen and acknowledged are marked with a checkmark, while unread announcements have a view icon. This makes it easy for users to see which announcements are currently active, and revisit them if needed.
Jira administrators will see a Manage button, which allows navigating to the Manage Announcements screen. Non-administrators will not see this button.
How to Setup the Dashboard Gadget
Alright, now that we've sweet talked you into using our Dashboard Gadget, let's run through how to add it to your Default Dashboard.
From the main Jira Dashboard, click on the Jira Settings header on the top right, then “System”, and then under “User interface”, click on Default Dashboard. Finally, click on the Add gadget button to open the gadgets list on the right panel. Find the Announcement gadget and click Add to complate this setup. You’ll see the gadget is added to your dashboard.
Alternatively, you can add the Announcement gadget starting from your Jira Dashboard. Find and click on the Edit button at the top right of the dashboard.
You should now see the Default Dashboard along with actions in the top right for Add Gadget.
Click the Add gadget button, which will bring up the Gadget list on the right panel.
In the search bar at the top of the list, search for "Announcements", and click on the Add button. The Announcer gadget is now added to the System Dashboard, and you can rearrange the Dashboard however you see fit, and place the Announcer Gadget where you wish.
There is no need to save anything, as all the changes you make here are automatically saved. Once done, your dashboard gadget would most likely be empty, and look like this: