Gadgets

Gadgets allow you to add dynamic content to a Confluence page or Jira application dashboard. Confluence can display gadgets that support the OpenSocial specification, including third party gadgets. 

For more information about Atlassian gadgets, see the introduction to Atlassian gadgets and the big list of Atlassian gadgets.

To see a list of available gadgets in your Confluence site go to Help > Available Gadgets.

The following gadgets are bundled with Confluence. 

Name

Description

Confluence Page Gadget

The Confluence page gadget allows you to show content from a page on your Confluence site in a gadget. You can optionally configure the gadget to display links to view and/or edit the page on your Confluence site. The page gadget can also be displayed in canvas view, so that it takes up all of the space provided by your dashboard.

Activity Stream Gadget

The activity stream gadget is similar to the recently updated macro and shows a list of the most recently changed content within your Confluence site.

Confluence News Gadget

The Confluence news gadget is an example of a 'news feed' gadget that shows a list of recent Confluence Product Blogs and events at Atlassian.

Confluence Quicknav Gadget

The Confluence QuickNav gadget provides the Quick Navigation Aid functionality for searching the Confluence site. For more information on how to use this feature, refer to the Quick Navigation Aid section of Search.

Add a Confluence gadget to a page

Where a similar result can be achieved using standard Confluence macros (for example using the Include Page Macro instead of Confluence Page Gadget), we recommend using macros as they have better performance and are easier to configure than gadgets.

To add a Confluence gadget to a page:

  • In the editor go to Insert > Other Macros.
  • Select the gadget you wish to add, and use the preview area to configure the gadget.
  • Choose Insert.

See Gadget Macro for more information on adding the macro to your page, configuring the gadget itself and display options. 

Add a Jira gadget to a page

For displaying basic Jira information, such as issues and charts, we recommend using the Jira Issues Macro and Jira Chart Macro as these macros have better performance and are easier to configure than gadgets. 

If the Jira information you want to display is not available from either of these macros a gadget will likely do the trick. 

To add a Jira Gadget to a Confluence page:

    • In the editor go to Insert > Other Macros.
    • Select the gadget you wish to add, and use the preview area to configure the gadget.
    • Choose Insert.

See Gadget Macro for more information on adding the macro to your page, configuring the gadget itself and display options. 

tip/resting Created with Sketch.

If you don't see any Jira Gadgets in the macro browser, ask your Confluence administrator to add the Jira Gadget urls to the list of authorized external gadgets in Confluence, and check that the application link between Confluence and your Jira application is configured correctly. 


Add a Confluence gadget to your Jira application dashboard

To add a Confluence gadget to your Jira dasboard:

  1. Go to the dashboard by selecting the Dashboard link in the header.
  2. On the dashboard, Click Add Gadget.
  3. Use the gadget wizard to choose the gadgets you want to add. 

tip/resting Created with Sketch.

If you don't see any Confluence gadgets in the Jira gadget directory, ask your Jira administrator to add the gadget URLs as follows.

To add a Confluence gadget to your Jira application's gadget directory:

  1. In Confluence, go to Help > Available Gadgets and copy the gadget URL for the gadget you want to make available in Jira.
  2. In Jira, go to the dashboard and choose Add Gadget.
  3. Choose Manage Gadgets or Add Gadget to Directory (depending on your Jira application and version) 
  4. Paste in the Confluence gadget URL and choose Add Gadget.

The gadget will now be available from the Jira Gadget Directory.

Last modified on Aug 13, 2018

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.