Canned Search for Confluence Cloud

Release Notes for 5.0.0

Released on 30 Oct 2026


The slides above was generated using Confluence Slides using the content below.
To find out how it was done, you can check out this guide.



Improvement


Important: Licensing and administration update

  • Starting from version 5.0.0, a Confluence administrator must register for a license and enter the license key on the new License Configuration page.

  • After upgrading, verify that the license has been saved successfully and its status is Valid.

    • Note: If no valid license is detected, a license registration message will be displayed directly within the macros on your Confluence page.

  • Refer to the steps in Registering for a free License Key for more information.

Major UI Redesign & Enhanced Macros

This version introduces a redesigned configuration interface, richer search results, better handling of large searches, and license registration for CQL for Confluence. The new full-screen macro editor features live preview and powerful query helpers for easier configuration.

Screenshot 2026-10-29 at 3.00.46 PM.png

What’s New:

  • Configure macros in a full-screen editor with separate Query and Display tabs, a resizable live preview, and clearer save button.

  • Build searches using guided filters or edit CQL directly with dynamic variables and ready-to-use examples.

  • Preview and copy the executed CQL directly from the macro, or use the shortcut button to open it in Confluence search.

  • Register and validate the app license through Confluence administration.


CQL Search macro

Basic Query Mode

image-20261028-091016.png
  • Build searches using guided mode, with options to filter by search text, title, spaces, contributors, content types, labels, and last-modified dates.

CQL Query Mode

image-20261028-091050.png
  • CQL mode now includes syntax highlighting, insertable dynamic variables, and searchable examples.

Display Configuration

image-20261028-090929.png
  • Choose which details to display in list results; including excerpts, content type, space, and last-updated date and time.

  • View clearer content-type labels and icons in search results.

  • View the executed query, search term, and total number of matches directly in the published macro.

Live Preview

image-20261028-091142.png
  • The live preview shows how your query and display settings affect the results.

Contributor Display Mode

  • image-20261029-032753.png

    Contributor counts now reflect the entire result set, not just the current page.

  • Select contributors from the list to filter results, or use Select all and Clear selection to manage your selection.

  • View contributors for each content result, with long lists collapsed after five people.


CQL Search Table macro

Display Configuration

image-20261029-024631.png
  • Select table columns from the available options in the configuration form

  • Choose from 12 column options: S/N, Title, Space, Type, Created, Modified, Creator, Modifier, Labels, Version, Comments, and Excerpt.

  • Choose from five date formats for the Created and Modified columns. Dates are displayed in the viewer’s local timezone.

CQL Search Table UI

image-20261029-024952.png
  • Tables use consistent column sizing and horizontal scrolling for wide configurations.

  • Viewers can sort the visible rows by selecting any column header.

  • The executed query and total match count can be inspected from the published macro.


CQL Counter macro

Display Configuration

image-20261029-031727.png
  • The counter is now displayed as an accessible card instead of a generated image.

  • Customise the board size, content alignment, board colour, footer text, and refresh settings.

  • Add optional footer text up to 100 characters. The card displays the first 16 characters, with the full text available in a tooltip.

CQL Counter Macro UI

image-20261029-031903.png
  • Large counts are displayed as 99999+; with the exact count available in the tooltip and query details.

  • View the last-updated time and optionally display the executed CQL.

  • When refresh is enabled, click the card to refresh the count. If an error occurs, select Try again to retry.

CQL Navigation macro

image-20261029-064117.png
  • Configure the navigation bar macro to sort pages by their position under the same parent, creation date, last-modified date, or title.

Display Configuration

image-20261029-075321.png
  • Page-position navigation follows the order set in the Confluence page tree.

  • Choose from four icon styles for the Previous and Next buttons: None, Basic, Circle, or Chevron.

  • The Table of Contents button displays the configured page sequence, highlights the current page, and loads more pages as you scroll.

Live Preview

image-20261029-075208.png
  • Configure navigation mode, page ordering, button position, size, text, and colour, with a live preview of the layout and table-of-contents behaviour.

Search this Space page

Search this Space is a space-level page, not an insertable macro.

image-20261029-081341.png
  • Search across pages, blog posts, comments, attachments, whiteboards, databases, embeds, and folders.

  • Select or clear multiple content types from a single filter menu.

  • Show excerpts and image-attachment thumbnails when needed

  • Choose and reorder result columns.

  • Resize columns, sort results, and filter the current page by title.

  • View the CQL query generated by the search filters.