Content by Label Macro

{contentbylabel:label=documentation|maxResults=5}

• Home page:
  Bamboo documentation (Bamboo latest)

  • documentation
  • enable-landing-page
• Page:
  Integrating Crowd with Atlassian Jira (Crowd 6.1 documentation)

  • osuser
  • documentation
  • integration
  • jira
  • confluence
  • application
  • connectors
  • single-sign-on
  • sso
• Page:
  Integrating Crowd with Atlassian Jira (Crowd 6.2 documentation)

  • osuser
  • documentation
  • integration
  • jira
  • confluence
  • application
  • connectors
  • single-sign-on
  • sso
• Page:
  Integrating Crowd with Atlassian Jira (Crowd 7.0 documentation)

  • osuser
  • documentation
  • integration
  • jira
  • confluence
  • application
  • connectors
  • single-sign-on
  • sso
• Page:
  Integrating Crowd with Atlassian Jira (Crowd 6.3 documentation)

  • osuser
  • documentation
  • integration
  • jira
  • confluence
  • application
  • connectors
  • single-sign-on
  • sso

(author)

None

Filter the results by author. The macro will display only the pages etc which are written or updated by the author(s) you specify here.

You can specify one or more authors, separated by a comma.

Label(s)
(label) or (labels)

None

This parameter is required.

Use this parameter to filter the results by label. The macro will display only the pages etc which are tagged with the label(s) you specify here.

You can specify one or more label values, separated by a comma or a space.

• To exclude content which matches a given label, put a minus sign (-) immediately in front of that label value. For example: If you specify a label value of -badpage you will get only content which is not labelled with 'badpage'.
• To indicate that the results must match a given label value, put a plus sign (+) immediately in front of that label value. For example: If you specify a label value of +superpage,+goodpage you will get only content which has at least two labels, being 'superpage' and 'goodpage'.

Maximum Number of Pages
(max) or (maxResults)

15

Specify the maximum number of results to be displayed. Note that the results are sorted first, and then the maximum parameter is applied.

(operator)

OR

The operator to apply to the supplied lists of labels. By default, a page with any of the non-prefixed labels (that is, labels without a plus (+) or minus (-) sign immediately preceding it) will be listed. By using operator=AND, only pages with all of the supplied non-prefixed labels will be listed.

Be aware that this parameter only modifies the behaviour of the 'Label(s)' parameter and only affects label values without a plus (+) or minus (-) sign prefix. To avoid confusion or unexpected results, it is not recommended that the operator parameter be used in conjunction with any label values prefixed with '+' or '-' signs.

Show Labels for Each Page
(showLabels)

true

Show or hide labels for results.

Show Space Name for Each Page
(showSpace)

true

Show or hide spaces for results.

Reverse Sort
(reverse)

false

Use this parameter in conjunction with the sort parameter described below. Set reverse=true to change the sort from ascending to descending.

this parameter is ignored if the sort parameter is not specified.

Sort By
(sort)

modified

Specify how the results should be sorted. To change the sort order from ascending to descending, use the reverse parameter described above.

Note: If this parameter is not specified, the sort order defaults to descending order based on the last modification date.

Values:

• creation — Sort by the date on which the content was added.
• title — Sort alphabetically by title.
• modified — Sort by the date on which the content was last updated.

Restrict to these Spaces
(space) or (spaces)

@all, i.e. all spaces in your Confluence site.

This parameter allows you to filter content by space. The macro will display only the pages etc. which belong to the space(s) you specify here.

You can specify one or more space keys, separated by a comma or a space.

• To exclude content in a specific space, put a minus sign (-) immediately in front of that space key. For example: If you specify a space key of -BADSPACE you will get only content which is not in the BADSPACE.
• To indicate that the results must come from a specific space, put a plus sign (+) immediately in front of that space key. For example: If you specify a space key of +GOODSPACE you will get only content in GOODSPACE. (Note that this is not particularly useful, because each content item belongs to one space only. If you put a plus sign next to one space key and list other space keys too, the other space keys will be ignored.)

Special values:

List Title
(title)

None

Adds a title or heading to the list.

Include these Content Types Only
(type)

all

This parameter allows you to filter content by content type. The macro will display only the content of the type you specify here.

You can specify one or more types, separated by a comma or a space.

To exclude content of a given content type, put a minus sign (-) immediately in front of that content type. For example: If you specify a content type of -blogpost you will get pages and all other content except for blog posts.

Available values:

• page — Pages.
• blogpost or news — Blog posts, also known as news items.

Display Excerpts
(excerpt)

false

Displays excerpts for each page listed in the Content by Label macro. Note that you must define the excerpts on each of those pages, by adding the excerpt macro to each page. If a particular page does not have an excerpt defined, then the Content by Label macro will not attempt to show an excerpt for that page. The Content by Label macro will show only the first few lines of the excerpt for each page.