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, add gadgets to pages or blog posts with the Gadget macro. Confluence comes bundled with a few of its own gadgets which can be added to your pages or blog posts using the gadget macro using the Macro Browser. Refer to Confluence Gadgets for more information. However, you can access additional gadgets in this list if your Confluence Administrator has:
Unlike other macros in the Macro Browser, the name of each gadget macro in the macro browser is typically unique and follows the convention "<gadget-name> macro", where <gadget-name> is the name supplied by the gadget itself. |
Inserting Gadgets into a Confluence Page or Blog Post
To add a gadget to a page:
- Edit your page or blog post.
- Choose Insert > Other Macros.
- Click External Content to see a list of gadgets configured for use in your Confluence installation.
Some Confluence macros like the JIRA Issues, JIRA Portlet, RSS Feed, Tasklist and Widget Connector macros also appear in this category because they can also access external content.
- Click on the desired gadget to access its parameters and properties and preview any changes to these values.
Almost all gadgets allow you to set basic parameters (listed below), which appear on the right of the Macro Browser. Each gadget may also have its own set of modifiable properties.
- Set the gadget's parameters and properties to your requirements.
- Click Refresh to update the gadget with any changes to parameters, properties or external data.
- Click Insert when finished.
Editing Gadgets on a Confluence Page or Blog Post
To edit an existing gadget on a page or blog post:
- Edit your page or blog post.
- Double-click on the Gadget macro placeholder.
- Set the gadget's parameters and properties to your requirements in the Macro Browser.
- Click Refresh to update the gadget preview in the Macro Browser with any changes to parameters, properties or external data.
- Save the gadget.
Almost all gadgets allow you to set basic parameters (listed below), which appear on the right of the Macro Browser. Each gadget may also have its own set of modifiable properties.
Parameters
Parameters are settings for Confluence gadgets, controlling presentation.
Parameter | Default | Description |
---|---|---|
Width | 450 pixels | Expands or shrinks the size of the gadget to match the specified width. The width can be specified in pixels (using |
Border | false | Places a thin grey border around the perimeter of the gadget. |
Contents of a Gadget Macro
The body of a 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.