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 InMigratable to Cloud?Default ValueDescription

space(s)

 (tick)

Server, Data Center

No

@self

Only lists pages from the specified list of spaces.

parent

 (error)

Server, Data Center

No


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.

(warning) May not be used with the ancestor parameter.

ancestor

 (error)

Server, Data Center

No


Any descendant of the specified page will be listed.

(warning) May not be used with the parent parameter.

branches

 (error)

Server, Data Center

No


 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

No


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

No

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

No


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

No


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

  • Ascending
  • Descending


Editor View

Tutorial Examples