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.

(info) For instructions on how to use Confluence gadgets in your applications, please see Confluence Gadgets.

Macros that work with the page gadget

Please note, not all macros work with the page gadget. Please refer to the Working Macros section below for more information.

On this page:

Related pages:

Screenshot: The Confluence page gadget displaying a sample page


Confluence Page Gadget Properties

Properties are settings for Confluence gadgets that allow the user to control the content or presentation of data retrieved by the gadget. These are similar to a Confluence macro's parameters. The table below lists relevant properties for this gadget.

Property

Required?

Default

Description

Space

No

None

Specify the space that your desired page is located in. Suggestions will display in a dropdown when you start typing.
(Note, this property is only used to make searching for pages easier. It is not required.)

Page

Yes

None

Specify the page that you want to display in your gadget. Suggestions will display in a dropdown when you start typing.

Show View Link

No

Yes

Select whether to display a link to view the page on your Confluence site. Clicking the link will open the page in Confluence.

Show Edit Link

No

No

Select whether to display a link to edit the page on your Confluence site. Clicking the link will open the page for editing in Confluence.

Refresh Interval

No

Never/false

Specify the time interval between each 'refresh' action undertaken by the page gadget. A refresh makes the activity stream gadget reflect any new activity that has been conducted on the Confluence site.

Working Macros

The Confluence page gadget will only render a subset of the macros that are used in Confluence correctly. Refer to the table below for the list of macros that work and do not work with the page gadget and known limitations.

Some of the issues with macros in the page gadget can be worked around, if you are comfortable developing in Confluence. Please see Troubleshooting Macros in the Page Gadget for more information.

Key:
(tick) Works with the page gadget
(tick) * Partially works with the page gadget
(error) Does not work with the page gadget

Macro

Works with page gadget?

Limitations

Activity Stream

(error)

You cannot have another gadget embedded within the Confluence Page Gadget

Anchor (within a page)

(tick) *

Opens in a new page

Attachments

(tick)

N/A

Blog Posts

(tick)

N/A

Chart

(tick)

N/A

Children Display

(tick)

N/A

Content By Label

(tick)

N/A

Content By User

(tick)

N/A

Excerpt

(tick)

N/A

Gallery

(tick)

N/A

Include Page

(tick)

N/A

Info

(tick)

N/A

Labels List

(tick)

N/A

Livesearch

(error)

N/A

Note

(tick)

N/A

Metadata

(tick)

N/A

Metadata Summary

(tick)

N/A

Pagetree Search

(error)

N/A

Pagetree

(tick)

N/A

Panel

(tick)

N/A

Quick Nav

(error)

You cannot have another gadget embedded within the Confluence Page Gadget

Recently Updated

(tick)

N/A

RSS Feed

(tick)

N/A

Section & Column

(tick)

N/A

Spaces List

(tick)

N/A

Table of Contents

(tick) *

Works, however links will be opened in a new browser window when clicked.

Team Calendars for Confluence Server(error)

See here for the Improvement Request:

TEAMCAL-862 - Getting issue details... STATUS

View File (PDF or PPT)

(tick) *

Works, but you may need to refresh the gadget the first time (see CONF-19932).

Widget Connector

(tick) *

Only works for some content:

  • Works: blip.tv, Episodic, Flickr, Google Calendar, presentations on Google Docs, MySpace Video, Scribd, Skitch.com, SlideRocket, SlideShare, Viddler, Vimeo, YouTube, Dailymotion, Metacafe, FriendFeed, Yahoo Video, Wufoo HTML Form Builder
  • Does not work: FriendFeed, Google Gadgets, Google Video (consumer service discontinued), Twitter, Widgetbox, DabbleDB, BackType
  • No labels