---
title: "CQL Search"
canonical: "https://support.appfire.com/space/RDD/146310146/CQL%20Search"
format: markdown
---
> Macro (aura-html)


> Macro (excerpt)
> 
> ![Dashboard Hub CQL Search](media://a17300ea-1a80-45f6-88ac-eacf72fa00a6)
> 
> 
> [CQL SEARCH](/wiki/pages/resumedraft.action?draftId=144015423)
> 
> [Display a list of Confluence content (pages, posts, etc.) based on a CQL query](/wiki/pages/resumedraft.action?draftId=144015423)

## Overview

This gadget brings Confluence content to your team’s dashboard, displaying content based on a given Confluence Query Language (CQL) query. Introduce a CQL query to filter and return content (pages, posts, etc.) from a Confluence instance, and select the columns to show.

For example, to list all the pages (type = page) in the space *Teams in Space* (space = TIS) with the label, space_mission (label = space_mission), you would use the following CQL query:

`space = TIS and type=page and  label = space_mission`.

Refer to the [CQL documentation](https://developer.atlassian.com/server/confluence/advanced-searching-using-cql/) to learn more about writing queries in Confluence.

## Configuration

Name your gadget meaningfully, so everyone knows at a glance what it is about and when to use it. Fill out the rest of the fields as applicable, namely:

- The **datasource**, where the Confluence instance is installed.
- The **columns** that will appear in the list to display the search results. The title is set by default as the minimum column to be displayed.
- The** CQL (Confluence Query Language) query** to filter the list of content (see the [CQL documentation](https://developer.atlassian.com/server/confluence/advanced-searching-using-cql/)). If you don’t add any, the gadget will not request any content, because it would fetch all the content in the source instance, causing performance issues. You have to add at least one clause, for example to list a space `space = TIS`. And remember that the gadget returns the results of the query, which are not fixed and could change over time.
- Finally, indicate if you want to use the current settings for all the compatible gadgets in the dashboard. This option eases the pain of configuring one by one the rest of the gadgets with the same default configuration

## Integrations

- :confluence:

<details>
<summary>Confluence</summary>

> Macro (contentbylabel)
</details>

We are working on our growing catalog of [https://appfire.atlassian.net/wiki/spaces/RDD/pages/146309915](https://appfire.atlassian.net/wiki/spaces/RDD/pages/146309915) and [https://appfire.atlassian.net/wiki/spaces/RDD/pages/146310010](https://appfire.atlassian.net/wiki/spaces/RDD/pages/146310010), but contact us you want us to expedite a specific one, visit our [https://appfire.atlassian.net/wiki/spaces/RDD/pages/146309984](https://appfire.atlassian.net/wiki/spaces/RDD/pages/146309984).

## Dashboards

This gadget is not included in any pre-defined dashboard.