Content Options

Description

Generates a set of options linking to Confluence content (e.g. pages, blog posts, etc).

May be filtered in several ways. Must be contained inside a List Data macro.


Parameters

NameRequiredAvailable InDefault ValueDescription

space(s)

 (tick)

Server, Data Center

@self

Only lists pages from the specified list of spaces.

parent

 (error)

Server, Data Center


Only immediate children of the specified page will be listed. You can specify both the page and space key here, but this must be done using the standard Confluence link syntax.

e.g.: "KEY:Page Name". Combining with 'spaces' will help efficiency.

ancestor

 (error)

Server, Data Center


Any descendant of the specified page will be listed.

branches

 (error)

Server, Data Center


 Specifies the type of pages that will be listed. May be one of:

  • all - (default) All page types are returned.
  • parents - Only pages with children are listed.
  • children - Only pages with no children are listed.

labels

 (error)

Server, Data Center


Specify labels which the content may contain ('xxx'), must contain ('+yyy') or may not contain ('-zzz').

Example:

  • "foo, bar": must have either 'foo' or 'bar'.
  • "+foo, -bar": must have 'foo', cannot have 'bar'.

limit

 (tick)

Server, Data Center

100

Available in v5.0.5. Maximum number of searches a user should see. Enter an integer value between 1 and 500.

(warning) If the value is bigger than 500, the macro will default to displaying a maximum of 500 results.

Sort By

 (error)

Server, Data Center


Specifies the Sort mode of the content options list by:

  • Page title
  • Date created
  • Date modified
  • By favourite page.

Order By

 (error)

Server, Data Center


Specifies the order mode for the selected option in "Sort by" parameter to be either:

  • Ascending
  • Descending


Editor View

Tutorial Examples