In this page

What is CQL?

CQL (Confluence Query Language) is Confluence's built-in query language for searching content, similar in spirit to SQL. It lets you flexibly search for pages, blog posts, and other types of content, using an extensive set of fields, functions, and operators.

Here's what manually running a CQL search looks like:

CQL searches aren't limited to manual use, though: apps can run them too, to power their own features. Better Content Archiving is no exception, as described next.

How to use CQL in the Better Content Archiving app?

Because the app uses CQL to determine which pages, blog posts, and other contents a feature applies to, its features are extremely flexible.

CQL is used to filter content in the following features:

  1. In the Content Status List macro, to determine which contents should appear in the list displayed on a page or blog post.
  2. In content status schemes, to determine which contents should have a given status.
  3. In notification schemes, to collect which contents should be listed in the notification email.
  4. In automation schemes, to collect which contents should be archived or deleted.
  5. Plus, anywhere else in Confluence, to run structured searches manually, or to power a feature of the platform or of another app. (The CQL queries and the CQL fields the Better Content Archiving app provides can be used there too!)

Questions?

Ask us any time.