This page last changed on Jun 26, 2008 by smaddox.

The Contentbylabel macro lists content which has been tagged with specific labels.

On this page:

Error formatting macro: toc: java.lang.NullPointerException

Usage

What you need to type What you will get
{contentbylabel:documentation, my:stuff}
1. System Requirements (Crowd 1.3) Labels: documentation, crowd, guide, api, overview
1. System Requirements (Crowd 1.2) Labels: overview, api, guide, crowd, documentation
1. System Requirements (Crowd 1.1) Labels: documentation, crowd, guide, api, overview
1.1 Concepts (Crowd 1.3) Labels: provisioning, login, sso, security, concepts, identity, single-sign-on, authorisation, authentication, application, directory, integration, api, middleware, architecture, framework, overview, guide, documentation, crowd
1.1 Concepts (Crowd 1.2) Labels: crowd, documentation, guide, overview, framework, architecture, middleware, api, integration, directory, application, authentication, authorisation, single-sign-on, identity, concepts, security, sso, login, provisioning
1.1 Concepts (Crowd 1.1) Labels: provisioning, login, sso, security, concepts, identity, single-sign-on, authorisation, authentication, application, directory, integration, api, middleware, architecture, framework, overview, guide, documentation, crowd
1.1 Setting JAVA_HOME (Crowd 1.3) Labels: overview, api, guide, crowd, documentation
1.1 Setting JAVA_HOME (Crowd 1.2) Labels: documentation, crowd, guide, api, overview
1.1 Setting JAVA_HOME (Crowd 1.1) Labels: overview, api, guide, crowd, documentation
1.2 About the Crowd Administration Console (Crowd 1.3) Labels: administration, documentation, overview, installation, crowd, console
1.2 About the Crowd Administration Console (Crowd 1.2) Labels: console, crowd, installation, overview, documentation, administration
1.2 About the Crowd Administration Console (Crowd 1.1) Labels: administration, documentation, overview, installation, crowd, console
2. Installing Crowd and CrowdID (Crowd 1.3) Labels: crowd-home, crowdid, overview, api, crowd, documentation, guide
2. Installing Crowd and CrowdID (Crowd 1.2) Labels: guide, documentation, crowd, api, overview, crowdid
2. Installing Crowd and CrowdID (Crowd 1.1) Labels: crowdid, overview, api, crowd, documentation, guide
2.1 Connecting Crowd to a Database (Crowd 1.3) Labels: documentation, crowd, installation, configuration, setup, database
2.1 Connecting Crowd to a Database (Crowd 1.2) Labels: database, setup, configuration, installation, crowd, documentation
2.1 Connecting Crowd to a Database (Crowd 1.1) Labels: documentation, crowd, installation, configuration, setup, database
2.1.1 HSQL DB (Crowd 1.2) Labels: database, setup, documentation, installation, install, hsql
2.1.1 HSQL DB (Crowd 1.1) Labels: hsql, install, installation, documentation, setup, database
2.1.1 HSQLDB (Crowd 1.3) Labels: hsql, install, installation, documentation, setup, database
2.1.2 MS SQL Server (Crowd 1.3) Labels: database, setup, msqlserver, msql, installation, crowd, documentation
2.1.2 MS SQL Server (Crowd 1.2) Labels: documentation, crowd, installation, msql, msqlserver, setup, database
2.1.2 MS SQL Server (Crowd 1.1) Labels: database, setup, msqlserver, msql, installation, crowd, documentation
2.1.3 MySQL (Crowd 1.3) Labels: database, setup, mysql, installation, crowd, documentation
2.1.3 MySQL (Crowd 1.2) Labels: documentation, crowd, installation, mysql, setup, database
2.1.3 MySQL (Crowd 1.1) Labels: database, setup, mysql, installation, crowd, documentation
2.1.5 PostgreSQL (Crowd 1.3) Labels: documentation, crowd, installation, postgresql, setup, database
2.1.5 PostgreSQL (Crowd 1.2) Labels: database, setup, postgresql, installation, crowd, documentation
2.1.5 PostgreSQL (Crowd 1.1) Labels: documentation, crowd, installation, postgresql, setup, database
2.2 Connecting CrowdID to a Database (Crowd 1.3) Labels: crowdid, database, setup, configuration, installation, crowd, documentation
2.2 Connecting CrowdID to a Database (Crowd 1.2) Labels: documentation, crowd, installation, configuration, setup, database, crowdid
2.2 Connecting CrowdID to a Database (Crowd 1.1) Labels: crowdid, database, setup, configuration, installation, crowd, documentation
2.2.1 HSQL DB (Crowd 1.2) Labels: install, installation, documentation, setup, database, crowdid, hsql
2.2.1 HSQL DB (Crowd 1.1) Labels: hsql, crowdid, database, setup, documentation, installation, install
2.2.1 HSQLDB (Crowd 1.3) Labels: hsql, crowdid, database, setup, documentation, installation, install
2.2.2 MS SQL Server (Crowd 1.3) Labels: crowdid, documentation, crowd, installation, msql, msqlserver, setup, database
2.2.2 MS SQL Server (Crowd 1.2) Labels: database, setup, msqlserver, msql, installation, crowd, documentation, crowdid
2.2.2 MS SQL Server (Crowd 1.1) Labels: crowdid, documentation, crowd, installation, msql, msqlserver, setup, database
2.2.3 MySQL (Crowd 1.3) Labels: crowdid, documentation, crowd, installation, mysql, setup, database
2.2.3 MySQL (Crowd 1.2) Labels: database, setup, mysql, installation, crowd, documentation, crowdid
2.2.3 MySQL (Crowd 1.1) Labels: crowdid, documentation, crowd, installation, mysql, setup, database
2.2.5 PostgreSQL (Crowd 1.3) Labels: crowdid, database, setup, postgresql, installation, crowd, documentation
2.2.5 PostgreSQL (Crowd 1.2) Labels: documentation, crowd, installation, postgresql, setup, database, crowdid
2.2.5 PostgreSQL (Crowd 1.1) Labels: crowdid, database, setup, postgresql, installation, crowd, documentation
3.2.03 Integrating Crowd with Atlassian Confluence (Crowd 1.3) Labels: sso, single-sign-on, client, atlassian-user, osuser, connectors, application, integration, crowd, documentation, confluence
3.2.03 Integrating Crowd with Atlassian Confluence (Crowd 1.2) Labels: confluence, documentation, crowd, integration, application, connectors, osuser, atlassian-user, client, single-sign-on, sso
3.2.04 Integrating Crowd with Atlassian CrowdID (Crowd 1.3) Labels: openid, osuser, documentation, integration, jira, confluence, favourite, application, connectors, single-sign-on, sso
3.2.04 Integrating Crowd with Atlassian CrowdID (Crowd 1.2) Labels: sso, single-sign-on, connectors, application, favourite, confluence, jira, integration, documentation, osuser, openid
3.2.06 Integrating Crowd with Atlassian JIRA (Crowd 1.3) Labels: sso, single-sign-on, connectors, application, confluence, jira, integration, documentation, osuser
3.2.06 Integrating Crowd with Atlassian JIRA (Crowd 1.2) Labels: osuser, documentation, integration, jira, confluence, application, connectors, single-sign-on, sso
3.2.11 Integrating Crowd with a Custom Application (Crowd 1.3) Labels: connectors, application, soap, custom, client, integration, documentation, crowd, authentication, api
3.2.11 Integrating Crowd with a Custom Application (Crowd 1.2) Labels: api, authentication, crowd, documentation, integration, client, custom, soap, application, connectors
3.2.3 Integrating Crowd with Atlassian Confluence (Crowd 1.1) Labels: sso, single-sign-on, client, atlassian-user, osuser, connectors, application, integration, crowd, documentation, confluence
3.2.4 Integrating Crowd with Atlassian CrowdID (Crowd 1.1) Labels: openid, osuser, documentation, integration, jira, confluence, favourite, application, connectors, single-sign-on, sso
3.2.6 Integrating Crowd with Atlassian JIRA (Crowd 1.1) Labels: sso, single-sign-on, connectors, application, confluence, jira, integration, documentation, osuser
3.2.8 Integrating Crowd with a Custom Application (Crowd 1.1) Labels: connectors, application, soap, custom, client, integration, documentation, crowd, authentication, api
4. Configuring Crowd (Crowd 1.3) Labels: build, configuration, properties, guide, documentation, crowd, crowdid
4. Configuring Crowd (Crowd 1.2) Labels: crowdid, crowd, documentation, guide, properties, configuration, build
4. Configuring Crowd (Crowd 1.1) Labels: build, configuration, properties, guide, documentation, crowd, crowdid
5.2 Configuring Caching for an Application (Crowd 1.1) Labels: defaultcache, integration, application, performance, administration, ehcache, caching, crowd, documentation
About the Crowd Administration Console (Crowd 1.4) Labels: console, crowd, installation, overview, documentation, administration
Application Integration Overview (Crowd 1.3) Labels: documentation, authentication, api, overview
Application Integration Overview (Crowd 1.2) Labels: overview, api, authentication, documentation
Application Integration Overview (Crowd 1.1) Labels: documentation, authentication, api, overview
Application Integration Overview (Crowd 1.4) Labels: overview, api, authentication, documentation
Bamboo 1.1 Documentation Home (Bamboo 1.1) Labels: documentation
Bamboo 1.2 Documentation Home (Bamboo 1.2) Labels: documentation
Bamboo Documentation Home (Bamboo 2.0) Labels: documentation
Bamboo Documentation Home (Bamboo 2.1) Labels: documentation
Character encodings in Confluence (Confluence 2.8) Labels: documentation, internal, http, database, confluence, utf8, unicode, encoding, character
Character encodings in Confluence (Confluence 2.7) Labels: character, encoding, unicode, utf8, confluence, database, http, internal, documentation
Character encodings in Confluence (Confluence 2.6) Labels: documentation, internal, http, database, confluence, utf8, unicode, encoding, character
Character encodings in Confluence (Confluence 2.5.6) Labels: documentation, internal, http, database, confluence, utf8, unicode, encoding, character
Character encodings in Confluence (Confluence 2.5) Labels: documentation, internal, http, database, confluence, utf8, unicode, encoding, character
Character encodings in Confluence (Confluence 2.9) Labels: character, encoding, unicode, utf8, confluence, database, http, internal, documentation
Concepts (Crowd 1.4) Labels: crowd, documentation, guide, overview, framework, architecture, middleware, api, integration, directory, application, authentication, authorisation, single-sign-on, identity, concepts, security, sso, login, provisioning
Configuring Caching for an Application (Crowd 1.3) Labels: defaultcache, integration, application, performance, administration, ehcache, caching, crowd, documentation
Configuring Caching for an Application (Crowd 1.2) Labels: documentation, crowd, caching, ehcache, administration, performance, application, integration, defaultcache
Configuring Caching for an Application (Crowd 1.4) Labels: documentation, crowd, caching, ehcache, administration, performance, application, integration, defaultcache
Configuring Crowd (Crowd 1.4) Labels: crowdid, crowd, documentation, guide, properties, configuration, build
Confluence 1.4 Home (Confluence 1.4 User Guide) Labels: documentation, userguide
Confluence 2.0 Home (Confluence 2.0) Labels: guide, user, documentation, userguide, favourite, confluence20, contents
Confluence 2.0 to 2.5 Documentation (Confluence 2.5) Labels: admin, example, installation, documentation
Confluence 2.0 to 2.5 User Guide (Confluence 2.5) Labels: guide, user, documentation, userguide, favourite, confluence20, contents
Confluence 2.5.4 to 2.5.8 Documentation (Confluence 2.5.6) Labels: admin, example, installation, documentation
Confluence 2.6 Documentation Home (Confluence 2.6) Labels: admin, example, installation, documentation
Confluence 2.6 User Guide (Confluence 2.6) Labels: guide, user, documentation, userguide, favourite, confluence20, contents
Confluence 2.7 Documentation Home (Confluence 2.7) Labels: documentation, installation, example, admin
Confluence 2.7 User Guide (Confluence 2.7) Labels: contents, confluence20, favourite, userguide, documentation, user, guide
Confluence Documentation Home (Confluence 2.8) Labels: admin, example, installation, documentation
Confluence Documentation Home (Confluence 2.9) Labels: documentation, installation, example, admin
Confluence Internals (Confluence 2.8) Labels: documentation, internal, confluence
Confluence Internals (Confluence 2.7) Labels: confluence, internal, documentation
Confluence Internals (Confluence 2.6) Labels: documentation, internal, confluence
Confluence Internals (Confluence 2.5.6) Labels: documentation, internal, confluence
Confluence Internals (Confluence 2.5) Labels: documentation, internal, confluence
Confluence Internals (Confluence 2.9) Labels: confluence, internal, documentation
Confluence User Guide (Confluence 2.8) Labels: guide, user, documentation, userguide, favourite, confluence20, contents
Confluence User Guide (Confluence 2.5.6) Labels: guide, user, documentation, userguide, favourite, confluence20, contents
Confluence User Guide (Confluence 2.9) Labels: contents, confluence20, favourite, userguide, documentation, user, guide
Connecting Crowd to a Database (Crowd 1.4) Labels: database, setup, configuration, installation, crowd, documentation
Connecting CrowdID to a Database (Crowd 1.4) Labels: documentation, crowd, installation, configuration, setup, database, crowdid
Crowd 1.1 Documentation (Crowd 1.1) Labels: crowd, documentation
Crowd 1.2 Documentation (Crowd 1.2) Labels: documentation, crowd
Crowd Documentation (Crowd 1.3) Labels: crowd, documentation
Crowd Documentation (Crowd 1.4) Labels: documentation, crowd
HSQLDB (Crowd 1.4) Labels: database, setup, documentation, installation, install, hsql
HSQLDB for CrowdID (Crowd 1.4) Labels: install, installation, documentation, setup, database, crowdid, hsql
Installing Crowd (Crowd 1.3) Labels: website-link, installation, documentation
Installing Crowd (Crowd 1.2) Labels: documentation, installation, website-link
Installing Crowd (Crowd 1.1) Labels: website-link, installation, documentation
Installing Crowd (Crowd 1.4) Labels: documentation, installation, website-link
Installing Crowd and CrowdID (Crowd 1.4) Labels: guide, documentation, crowd, api, overview, crowdid, crowd-home
Integrating Crowd with a Custom Application (Crowd 1.4) Labels: api, authentication, crowd, documentation, integration, client, custom, soap, application, connectors
Integrating Crowd with Atlassian Confluence (Crowd 1.4) Labels: confluence, documentation, crowd, integration, application, connectors, osuser, atlassian-user, client, single-sign-on, sso
Integrating Crowd with Atlassian CrowdID (Crowd 1.4) Labels: sso, single-sign-on, connectors, application, favourite, confluence, jira, integration, documentation, osuser, openid
Integrating Crowd with Atlassian JIRA (Crowd 1.4) Labels: osuser, documentation, integration, jira, confluence, application, connectors, single-sign-on, sso
Java Integration Libraries (Crowd 1.3) Labels: authorisation, verifytokenfilter, documentation, authentication, integration, api, httpauthenticator, java, securityserverclient
Java Integration Libraries (Crowd 1.2) Labels: securityserverclient, java, httpauthenticator, api, integration, authentication, documentation, verifytokenfilter, authorisation
Java Integration Libraries (Crowd 1.1) Labels: authorisation, java, securityserverclient, verifytokenfilter, documentation, authentication, integration, api, httpauthenticator
Java Integration Libraries (Crowd 1.4) Labels: securityserverclient, java, httpauthenticator, api, integration, authentication, documentation, verifytokenfilter, authorisation
MS SQL Server (Crowd 1.4) Labels: documentation, crowd, installation, msql, msqlserver, setup, database
MS SQL Server for CrowdID (Crowd 1.4) Labels: database, setup, msqlserver, msql, installation, crowd, documentation, crowdid
MySQL (Crowd 1.4) Labels: documentation, crowd, installation, mysql, setup, database
MySQL for CrowdID (Crowd 1.4) Labels: database, setup, mysql, installation, crowd, documentation, crowdid
PostgreSQL (Crowd 1.4) Labels: database, setup, postgresql, installation, crowd, documentation
PostgreSQL for CrowdID (Crowd 1.4) Labels: documentation, crowd, installation, postgresql, setup, database, crowdid
Related Labels Macro (Confluence 2.8) Labels: confluence-label-filter, documentation
Related Labels Macro (Confluence 2.7) Labels: documentation, confluence-label-filter
Related Labels Macro (Confluence 2.6) Labels: confluence-label-filter, documentation
Related Labels Macro (Confluence 2.5.6) Labels: confluence-label-filter, documentation
Related Labels Macro (Confluence 2.5) Labels: documentation
Related Labels Macro (Confluence 2.0) Labels: documentation
Related Labels Macro (Confluence 2.9) Labels: documentation, confluence-label-filter
Setting JAVA_HOME (Crowd 1.4) Labels: documentation, crowd, guide, api, overview
System Requirements (Crowd 1.4) Labels: overview, api, guide, crowd, documentation
Working with Macros (Confluence 2.8) Labels: documentation, index, summary, all, list, macro, confluence
Working with Macros (Confluence 2.7) Labels: confluence, macro, list, all, summary, index, documentation
Working with Macros (Confluence 2.6) Labels: documentation, index, summary, all, list, macro, confluence
Working with Macros (Confluence 2.5.6) Labels: documentation, index, summary, all, list, macro, confluence
Working with Macros (Confluence 2.5) Labels: documentation, index, summary, all, list, macro, confluence
Working with Macros (Confluence 2.0) Labels: confluence, macro, list, all, summary, index, documentation
Working with Macros (Confluence 2.9) Labels: confluence, macro, list, all, summary, index, documentation


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

Recommended Default Usage

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

{contentbylabel:needs-fixing|showLabels=false|maxResults=99|showSpace=false|key=@self}

Optional Parameters

No  Parameter Default Description
 1 key all Specify a space key to show the results for a particular space.
Keywords: @all shows results from all spaces; @self shows results from only the current space.
 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. You can also use the 'reverse' parameter (see below) to optionally reverse the sorting.
 8 reverse=true false If you are using the 'sort' parameter (see above), you can also use the 'reverse' parameter change the sort order.
 9 operator OR 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.

Examples

1. Filter by space

{contentbylabel:dogs,cats|key=PETS}

2. Show only results in current space

{contentbylabel:dogs,cats|key=@self}

3. Show results from all spaces

{contentbylabel:dogs,cats|key=@all}

4. Filter by content type: pages or blog posts

{contentbylabel:dogs,cats|type=page,blogpost}

5. Hide labels for results

{contentbylabel:dogs,cats|showLabels=false}

6. Hide spaces for results

{contentbylabel:dogs,cats|showSpace=false}

7. Display excerpts for results

{contentbylabel:dogs,cats|excerpt=true}

8. Specify the maximum number of results to display

{contentbylabel:dogs,cats|maxResults=99}

9. Sort by creation date, modification date or title

{contentbylabel:dogs,cats|sort=title}

10. Change the sort order

{contentbylabel:dogs,cats|sort=title|reverse=true}
RELATED TOPICS

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

Take me back to Confluence User Guide

Document generated by Confluence on Aug 07, 2008 19:09