This documentation relates to Gadgets and Dashboards 3.0.x
If you are using an earlier version, please view the previous versions of the Gadgets documentation and select the relevant version.

Gadget subscription is not yet implemented in all applications

Note that, although this feature is now part of the framework, it has not yet been included into all Atlassian applications. For information on application versions, see the version matrix.

Security implications

Add only gadgets from sources that you trust. Gadgets can allow unwanted or malicious code onto your web page and into your application. A gadget specification is just a URL. The functionality it provides can change at any time.

On this page:

Subscribing to Gadgets

If you have administrator privileges, you can configure your application to subscribe to gadgets from other Atlassian applications. This feature allows administrators to make all the gadgets from one application available in another application, without having to enable each gadget individually via the gadget URL.

To make use of this feature, you will need two or more applications that support the feature.

The gadgets included are those provided by the other application or via plugins installed into that application. They do not include external gadgets that the other application has added to its directory.

To subscribe to gadgets from another application,

  1. Go to the dashboard by clicking the 'Dashboard' link or the 'Home' link at the top left of the screen.
  2. The dashboard appears. Click 'Add Gadget'.
  3. The 'Add Gadget' screen appears, showing the list of gadgets in your directory. See the gadget directory screenshot below. Click 'Gadget Subscriptions'.
    (info) You will only see this button if you have administrator permissions for your dashboard, and if your application supports gadget subscriptions.
  4. The 'Gadget Subscriptions' screen appears, showing the applications to which your application already subscribes. Click 'Add Subscription'.
  5. The 'Add Subscription' screen appears. See the screenshot below. Enter the base URL of the application you want to subscribe to. For example, http://example.com/jira or http://example.com/confluence.
  6. Click 'Finished' to add the subscription.


Screenshot: Gadget directory with 'Gadget Subscriptions' button



Screenshot: Adding a gadget subscription

Example Scenarios

When would you use gadget subscription?

  • For example, let's say you have a JIRA site that publishes some gadgets and a Confluence site that can display gadgets. The Confluence administrator would not need to add each gadget individually. Instead, your Confluence site could subscribe to JIRA's gadgets, making all your JIRA gadgets immediately available for inclusion on Confluence pages. The JIRA gadgets will show up in the Confluence macro browser, and Confluence users will be able to add the JIRA gadgets to their wiki pages.
  • As another example, let's say that you have two Confluence sites. One is external, used by customers as well as your own employees. The other is internal, used by your employees only. Your internal Confluence site can subscribe to the gadgets from your external Confluence site, so that you can display information internally about the external site.
RELATED TOPICS

Gadgets and Dashboards User Guide
Gadgets and Dashboards Administration Guide

  • No labels