Allows you to add Confluence gadgets to pages or blog posts.

Gadgets are small applications that can offer dynamic content. They are typically served from a web application server and can be re-used in many other web applications. In Confluence, use the Gadget macro to add gadgets to pages or blog posts.

Confluence comes bundled with a few of its own gadgets that you can add to your pages or blog posts. The Confluence gadgets are listed in Confluence Gadgets. However, you can access additional gadgets in this list if your Confluence Administrator has:

  • Installed additional gadgets in Confluence (typically as a Confluence plugin) or
  • Registered gadgets served from an external web application or website (such as those from a JIRA installation or iGoogle).

Unlike other macros, the name of each gadget macro is unique and follows the convention "<gadget-name> macro", where <gadget-name> is the name supplied by the gadget itself.

 On this page:

Related pages:


Inserting gadgets into a Confluence page or blog post

To add a gadget to a page:

  1. Edit your page or blog post.
  2. Choose Insert > Other Macros.
  3. Click External Content to see a list of gadgets configured for use in your Confluence installation.
    (Some Confluence macros like the JIRA Issues, RSS Feed, Tasklist and Widget Connector macros also appear in this category because they can also access external content.)
  4. Click the desired gadget to access its parameters and properties.
    Almost all gadgets allow you to set basic parameters (listed below), which appear on the right of the macro dialog. Each gadget may also have its own set of parameters, which appear on the left of the macro dialog.
  5. Set the parameters to your requirements.
  6. Click Refresh to preview your changes.
  7. Click Insert to add the gadget to the page.

Editing gadgets on a Confluence page or blog post

To edit an existing gadget on a page or blog post:

  1. Edit your page or blog post.
  2. Click the Gadget macro placeholder and choose Edit (or double-click the placeholder).
  3. Set the gadget's parameters to your requirements.
  4. Click Refresh to preview your changes.
  5. Save the gadget.

 

Standard gadget parameters

Almost all gadgets allow you to set basic parameters (listed below), which appear on the right of the macro dialog. Each gadget may also have its own set of parameters, which appear on the left of the macro dialog.

Parameter

Default

Description

Width

450 pixels

Set the width of the gadget, using one of the following conventions:

  • Width in pixels, using px or plain numbers. For example, 500px or 500
  • A percentage of the page width, using %. For example, 50%
  • Automatic resizing of the gadget to fit 100% of the page width: auto

Border

true

Places a thin grey border around the gadget.

Contents of a Gadget macro

In the addition to the standard parameters, the gadget macro contains 'parameter-like' content, which represents specific property settings that are particular to each gadget. Hence they are not documented here. Typically, this content would only be changed by customising the gadget's default properties using the macro browser.

Code examples

See: