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 Adding a dropdown list of users macro.

See the Populating a List with Confluence Pages guide as an example of how to use this macro.


Parameters

NameRequiredAvailable InMigratable to Cloud?Default ValueDescription
space(s)
 Yes
Server, Data Center
No
@self
Only lists pages from the specified list of spaces.
parent
 Optional
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
 Optional
Server, Data Center
No

Any descendant of the specified page will be listed.

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

branches
 Optional
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
 Optional
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
 Yes
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
 Optional
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
 Optional
Server, Data Center
No

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

  • Ascending
  • Descending

Tutorial Examples