Confluence List Macro CQL

Rhys Gottwald
Contributor
March 8, 2025

 

Hi, I have looked in help documentation and I cannot seem to find any help on the Insert Confluence List macro so I am coming here.

I what I need to do with the list is return a set of pages that;

  1. Are Verified and,
  2. Have a specific label.

I am adding a CQL query to the search bar the of the Macro, but the fact that I have entered a CQL query seems to be ignored and the entire content is used as the search term.

I know about the Filter by Label (Content by Label) macro, but I would preferred to use the List macro because I want the Table Layout and I cannot search only for pages that are verified.

So I guess my question is, can I use CQL in the Insert Confluence List macro?

1 answer

0 votes
Barbara Szczesniak
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
March 10, 2025

@Rhys Gottwald I can't seem to find a page on this macro either. In fact, I was surprised to find it in the list of available macros on a page (and was hoping there might be a help button in there, but no). The macro definition window just says search by keyword, so I'm not sure you can use a CQL query (gee, wouldn't it be nice if there was a page documenting how to use this macro? 🙃)

I did find a couple other questions where the community recommended using the Filter by Label macro, which may be because none of us know how to use the Insert Confluence List macro.

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PRODUCT PLAN
PREMIUM
PERMISSIONS LEVEL
Product Admin
TAGS
AUG Leaders

Atlassian Community Events