_CQLFields
CQL (Confluence Query Language) is a query language developed for Confluence, which you can use in some macros and the Confluence search. Confluence search and CQL-powered macros allow you to add filters to build up a search query, adding as many filters as you need to narrow down the search results.
Use the Add a filter link to add more filters to your query.
You can use the following CQL filters to build your query:
Filter | Description | Operators |
---|---|---|
Label* | Include pages, blog posts or attachments with these labels. | OR (multiple values in the same filter) AND (multiple Label filters) |
With ancestor | Include pages that are children of this page. This allows you to restrict the macro to a single page tree. | OR (multiple values in the same filter) |
Contributor** | Include pages or blog posts that were created or edited by these people. | OR (multiple values in the same filter) |
Creator | Include items created by these people. | OR (multiple values in the same filter) |
Mentioning user | Include pages and blog posts that @mention these people. | OR (multiple values in the same filter) |
With parent | Include only direct children of this page (further sub-pages won't be included) | EQUALS (one page only) |
In space** | Include items from these spaces. | OR (multiple values in the same filter) |
Including text** | Include items that contain this text. | CONTAINS (single word or phrase) |
With title | Include items that contain this text in the title. | CONTAINS (single word or phrase) |
Of type** | Include only pages, blogs or attachments. | OR (multiple values in the same filter) |
* This field is required in CQL-powered macros.
** You can add these filters in CQL-powered macros but in search they're part of the standard search filters, so they don't appear in the Add a filter menu.