Displays a list of pages tagged with one or more specified labels. Supports AND/OR label logic, excluded labels, title and body text search, content type filtering, and multi-space search. Replaces the deprecated Confluence Cloud Content by Label macro with significantly more functionality.
4.1 Content & Filter Tab
Required Fields
|
Field |
Type |
Description |
Required |
|---|---|---|---|
|
Labels |
Multi Select |
Select one or more labels. Pages tagged with any of these labels will appear in results. At least one label is required. |
Yes |
Optional Settings
|
Field |
Type |
Description |
Required |
|---|---|---|---|
|
Match any label |
Toggle |
When on (default): pages with at least one selected label are shown - OR logic. When off: only pages with all selected labels are shown - AND logic. |
No |
|
Exclude Current Page |
Toggle |
Hides the page the macro is placed on from the results. Default: off. |
No |
|
Add Filter |
Filter Panel |
Add optional filters to narrow results further. See Section 2 for all available filters. |
No |
|
Sort By |
Dropdown |
Sort results by: Title, Last Modified, or Created Date. |
No |
|
Descending/ Ascending |
Toggle |
Toggle the sort direction. Default: Descending (newest first). |
No |
💡 Label tips
Labels in Confluence Cloud are case-sensitive. "Design" and "design" are treated as different labels.
Use the Space filter in Add Filter to search across multiple spaces simultaneously.
Combine Labels to include and Labels to exclude to show all documentation pages but hide drafts.
4.2 Display, Layout & Advanced Tabs
These tabs are identical to Content by Author. Refer to sections 3.2, 3.3, and 3.4.
4.3 Use Cases
-
Related documentation - embed on any page to show all pages sharing the same label.
-
Knowledge base hub - show all pages tagged "how-to" or "tutorial" in the Support space.
-
Release notes index - show all pages tagged "release-notes", sorted by newest first.
-
Draft exclusion - include all pages tagged "api-docs" but exclude any tagged "draft".
-
Cross-space search - show pages tagged "security" across both Engineering and Product spaces using the Space filter.