---
title: "Quick start"
canonical: "https://support.appfire.com/space/RFC/477332481/Quick%20start"
format: markdown
---
> Macro (aura-html)

Here's a quick start guide to working with Reporting.

## Description

In this example, we will build a simple report that shows the number of likes on pages within a space.

![image](media://52c04b28-c36f-44b8-a1e3-d6bc801ec02d)

## Guide

1. Create a page and provide a suitable title and some descriptive text, like the example above.
2. Add a Reporting macro.
3. Start with some simple CQL syntax and search for the type of content you are trying to report on.  
For example, the query `type=page and space=RC` will match all the pages within the space *RC*.
  For details about the CQL syntax, refer to Atlassian’s page [Advanced Searching using CQL](https://developer.atlassian.com/server/confluence/advanced-searching-using-cql/).

> ⚠️ ### Fetching all results
> ⚠️ 
> ⚠️ By default, Reporting will only return the first 200 results from a query. This is done for performance reasons. There is a **Fetch all results** option below the query box, but be aware that enabling it may significantly increase the report loading time.
> ⚠️ 
> ⚠️ ![c345fc90-f3af-4951-a41d-c207678e3b62.png](media://191bd795-fd62-43a2-971d-edc4c7c8ca9e)

3. In the *Expansions *section, use the checkbox list to find and choose the expansions that contain the metadata you are <span style="color: #000000">looking</span> for. For this example, we are using *metadata.likes.users*.
4. In the *Report Builder* section, configure the first column of the report, which will contain the page titles.
  1. From the dropdown menu, select **Basic **and click **Add** to create the report block that will represent the column.
    *Block 0* appears.
  2. <span style="color: #172b4d">Click </span><span style="color: #172b4d">**Block 0**</span><span style="color: #172b4d"> to configure it.</span>
  3. <span style="color: #172b4d">In the </span><span style="color: #172b4d">**Title **</span><span style="color: #172b4d">box, </span>enter `Title`.
  4. <span style="color: #172b4d">From the </span><span style="color: #172b4d">**Value **</span><span style="color: #172b4d">menu, select</span><span style="color: #172b4d">** title**</span><span style="color: #172b4d">.</span>
  5. <span style="color: #172b4d">Click </span><span style="color: #172b4d">**Update**</span><span style="color: #172b4d">.</span>
5. Still in the *Report Builder* section, configure the second column of the report, which will contain the number of likes.
  1. From the dropdown menu, select **Text **and click **Add** to create the report block that will represent the column.
    *Block 1* appears.
  2. Click **Block 1** to configure it.
  3. In the **Title **box, enter `Likes`.
  4. From the **Value **menu, select** content.metadata.likes.count**.
  5. Click **Update**.
6. In the *Filters *section, fine-tune your results.  
In this example, enter `[:5]` to limit the report to a maximum of 5 results and click **Apply**.
7. In the *Report Type *section, choose how you want your results to be shown on the page.  
The options are **Table **(used for this example),** List **(bullet list), and** Block **(paragraph).
8. In the *Empty Report* section, configure the text shown if the report has no results.  
For this example, enter `No matching pages were found. Please try again later.`
9. **Save** the macro and **Publish **the page.

> ⚠️ The report is limited to 200 results. So if your search matches more than 200 results with data, only the first 200 will be shown.