User Guide for Canned Search for Confluence 1.2.0


By Upload

  1. Download the latest version from Marketplace
  2. Go to Add-ons page
  3. Click on Upload add-on
  4. Select the .jar file
  5. Click Upload
  6. The Canned Search for Confluence should be installed
  7. Click on Free trial or Buy now to configure and start using

By Searching in Atlassian Marketplace

  1. Go to Find new add-ons
  2. Search for Canned Search for Confluence in the search field
  3. Click Free trial or Buy now to install, configure and start using

*Canned Search for Confluence offers a free trial for 30 days. Thereafter, a license key is required in order to use the plugin.


Configuration Settings

Field NameRequiredDefault ValueExplanation
Enter a CQL statement with $$query$$ as the search term.
Hide Filenames in Excerpts

The files names are removed from excerpt when checked.

Please view Excerpt when filenames are removed for more information.

Default Query Term

Enter a default query term to replace the $$query$$ in CQL.
Search results will be preloaded if it is provided.
No. of Results per Page(tick)10

Select the no. of results to be displayed:

  • 5 — Pagination will occur if there are >5 search results
  • 10 — Pagination will occur if there are >10 search results
  • 50 — Pagination will occur if there are >50 search results
  • 100 — Pagination will occur if there are >100 search results

If there are more results than the selected no. of results to display, pagination will occur.


Search Results with Pagination

Without Pagination

With Pagination

Remove Image filenames from Returned Results 

This feature is available from version 1.2.0 onwards.

User now has a choice to remove filenames which have been attached to the page as images from their Except.

You may want to hide the filenames if:

  • The filenames shown in search result provides no useful information when shown to user
  • Filenames are just placeholders for images and readers complains that such placeholders affect their ability to read excerpts smoothly


Hide filenames in Excerpt



Hide filenames in Excerpt


  1. From Confluence Edit Page, edit the CQL Macro which you wish to hide images filenames in the Excerpt.
  2. Check Hide Filesnames in Excerpt
  3. Save Macro


  • If the filename contains a space (e.g. Canned Search.png), at it happens to be cut due to excerpt character limit, half of the file name (e.g. Canned...) will be present in the result excerpt
  • If a text e.g."file name.png" is added in the contents of the page, but has no such image being attached to the page, the String "file name.png" will not be removed from the excerpt.

Search Results and Warnings

No Results Found

When Empty Query Parameters are Entered

Syntax Error in CQL