/
Populate a list with Confluence pages

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

  1. Create a table as in the following image:

  1. 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.

  1. 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.

  1. Insert a Content Options macro In the List Data macro.

  2. 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.

  1. Click Insert and Publish the page.

  2. 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