Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.




  • Information for same topic can exist is scattered around in different spaces

  • Users might not know about key terms / available terms the keywords that they can use to look for help with

  • It takes a lot of time to collate information from all sources and place keep them up-to-date in a single page

The image below shows a simplified scenario whereby a page containing several key terms can be quickly created and can benefit from usage of CQL Search Macro.


Proposed Solution


  • Create template containing CQL Search Macro (using $self as Default Query Term).

  • Use template to create the individual pages for each key term quickly to present collated information on each key term.

Note: $self is recommended to be used so that pages can be created quickly as the page title will be used to as default query term

  • which will use the page title as the keyword to search for related content

  • The template can be used with Create from Template Macro to add new pages easily for each key term


The image below shows how the template can be used to collate all information on “Macro”Macro.

Similar page pages can be created quickly for other terms (E.g. tutorial, testing, setup) presented in a main page.



For the above page, the template is configured as follows:

  1. Create template with name

“Collate for Confluence”
  1. “Confluence Search Entry Template”

  2. Add CQL Search Macro in


For macro,

Set CQL to label = ‘confluence’ AND type IN (blogpost, page) AND text ~ $$query*$$
  1. the template

    1. Set the CQL to find all pages and blogposts which is labelled with confluence and contains the keyword matching with page title of the current page

      Code Block
      label = ‘confluence’ AND type IN (blogpost, page) AND text ~ $$query*$$ 
    2. Set Default Query Term to $self

Image Removed
    1. which will replace $$query*$$ with the title of the current page containing the CQL Search Macro

      Image Added