Populate a list with Confluence pages
This article shows how you can dynamically populate a list with pages created in Confluence. This can be done using the List Option and Content Options macros.
One of the advantages of doing this in this way is the list may grow or shrink over time depending on the content.
Ingredients
Apps | Scaffolding |
---|---|
Macros | Content Options, List Data |
Guide
Create a table as in the following image:
Insert Date Data macros as shown in the Start Date and End Date columns.
For this example, give the names startint
and endint
to the respective macros.
Insert a List Data macro in the Tutorials Selected column. Provide a suitable name and check the Allow Multiple checkbox.
In this example, give ScafTutorials
as the name.
Insert a Content Options macro In the List Data macro.
Enter a space name in Space(s) and add a page name in Parent.
For this example, enter the current space, SCAF
, and the Basic Tutorials page located in that space in Parent.
Click Insert and Publish the page.
Click Edit Contents to enter your data.
A list of Confluence pages appears in the list box in the Tutorials Selected column.
Remember that you can press Ctrl
to select multiple options.
Notes
For the Parent parameter:
If the parent/ancestor is in the same space, you can either enter just the page title or the space key followed by the page title.
If the parent/ancestor is in a different space, enter the space key followed by the page title. For example:
SPACE:Page Title
Beware of performance issues with Content Options. Use sparingly.
Result