This documentation relates to an earlier version of Confluence.
View this page in the current documentation or visit the current documentation home.

Content by Label Macro

Skip to end of metadata
Go to start of metadata
All Versions
Table of Contents

(info) You need to edit in 'Wiki Markup' mode to include macros in your page.

The Contentbylabel macro lists content associated with specific labels.

Contentbylabel Macro

What you need to type

What you will get

{contentbylabel:documentation, my:stuff}

Page: Exporting and Printing Technical Documentation (Confluence 4.2)
Labels: techcomm, documentation, technical-documentation, technical-communication, technical-writing, wiki, export, single-source-publishing, xml, eclipse-help, javahelp
Page: Further Reading about Developing Technical Documentation on Confluence (Confluence 3.5)
Labels: wiki, technical-writing, technical-communication, technical-documentation, documentation, techcomm
Page: Re-using Content in Technical Documentation (Confluence 3.5)
Labels: single-source-publishing, reuse, re-use, wiki, technical-writing, technical-communication, technical-documentation, documentation, techcomm
Page: Creating your Technical Documentation Space (Confluence 3.5)
Labels: theme, permissions, permission, wiki, technical-writing, technical-communication, technical-documentation, documentation, techcomm
Page: Integrating Crowd with a Custom Application (Crowd 2.2)
Labels: api, authentication, crowd, documentation, integration, client, custom, soap, application, connectors
Page: Integrating Crowd with Atlassian Confluence (Crowd 2.2)
Labels: confluence, documentation, crowd, integration, application, connectors, osuser, atlassian-user, client, single-sign-on, sso
Page: Managing the Life Cycle of your Technical Documentation (Confluence 3.4)
Labels: technical-documentation, wiki, technical-writing, technical-communication, documentation, techcomm, lifecycle, life-cycle, release, publishing, publication, review, workflow, draft
Page: Developing Technical Documentation on Confluence Wiki (Confluence 3.4)
Labels: technical-writing, techcomm, wiki, technical-communication, documentation, technical-documentation
Page: Creating your Technical Documentation Space (Confluence 3.4)
Labels: theme, permissions, permission, wiki, technical-writing, technical-communication, technical-documentation, documentation, techcomm
Page: Essential Confluence Features for Technical Documentation (Confluence 3.4)
Labels: column, section, video, table-of-contents, toc, wiki, technical-writing, technical-communication, technical-documentation, documentation, techcomm
Page: Confluence Plugins for Technical Documentation (Confluence 3.4)
Labels: attachment, layout, composition, tab, diagram, gliffy, wiki, technical-writing, technical-communication, technical-documentation, documentation, techcomm
Page: Confluence Documentation in Other Languages (Confluence 3.4)
Labels: wiki, confluence, translation, localisation, i18n, internationalisation, languages, documentation
Page: Installing Crowd and CrowdID (Crowd 2.1)
Labels: guide, documentation, crowd, api, overview, crowdid, crowd-home
Page: Connecting Crowd to a Database (Crowd 2.1)
Labels: database, setup, configuration, installation, crowd, documentation
Page: HSQLDB (Crowd 2.1)
Labels: database, setup, documentation, installation, install, hsql
Showing first 15 of 471 results


By default, Confluence lists all the labels for each result displayed. See optional parameters below to disable this.

Recommended Default Usage

To display all pages with the label needs-fixing, use:





Optional Parameters

No 

parameter

Default

Description

 1

key

all

Filter by space
(Note: Keywords @all and @self are available with Confluence 2.2.2 and higher.)

 2

type

false

Filter by content type

 3

showLabels

true

Show or hide labels for results

 4

showSpace

true

Show or hide spaces for results

 5

excerpt

false

Show or hide excerpts for results

 6

maxResults

5

Specify maximum results to display

 7

sort=creation
sort=title
sort=modified

recent

The 'sort' attribute is an optional attribute that allows you to configure how the children are sorted. Use the 'reverse' attribute to optionally reverse the sorting.

 8

operator

OR

(Confluence 2.5 and higher.) The operator to apply to the supplied lists of labels. By default, a page with any of the labels will be listed. By using operator=AND, only pages with all of the supplied labels will be listed.

1. Filter by space





2. Show only results in current space (Confluence 2.2.2 and higher)





3. Show results from all spaces (Confluence 2.2.2 and higher)





4. Filter by content type: pages or blog posts





5. Hide labels for results





6. Hide spaces for results





7. Display excerpts for results





8. Specify the maximum number of results to display





9. Sort by creation date, modification date or title




RELATED TOPICS

Related Labels Macro
Navmap Macro
Recently Used Labels Macro
Working with Labels Overview
Working with Macros

Take me back to Confluence 2.0 Home



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Tweet, blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.