---
title: "Report builder"
canonical: "https://support.appfire.com/space/RFC/477333116/Report%20builder"
format: markdown
---
> Macro (aura-html)

When you insert or edit a Reporting macro, <span style="color: #172b4d">the </span>*Report Builder*<span style="color: #172b4d"> section displays on the right. This </span>serves as the frame structure (container) for your report, and you can pick and add [report blocks](https://appfire.atlassian.net/wiki/spaces/RFC/pages/477333123) as needed. The choice of report blocks depends on the data format and how you want to present a specific value.

In <span style="color: #172b4d">the </span>*Report Builder*<span style="color: #172b4d"> </span>section, you can also configure the type of report you want to generate, set the default text for an empty report, and see a preview of the report.

![image](media://7fee4805-f558-411a-ac1c-a512335c47ad)

## Adding report blocks

[Report blocks](https://appfire.atlassian.net/wiki/spaces/RFC/pages/477333123) are used for selecting values and adding static text, which will be shown later in the report format of your choice.

For example, if you want to view the report as a table, each report block generates one column of results for the table.

To add one or more report blocks, click the dropdown menu, select the type of report block, and click **Add**.

![add_report_block.png](media://9c70567a-f157-4f47-acc1-f7263ed84bf9)

For information about the different types of report blocks and usage examples, see [https://appfire.atlassian.net/wiki/spaces/RFC/pages/477333123](https://appfire.atlassian.net/wiki/spaces/RFC/pages/477333123).

## Choosing a report type

Reporting can generate four different types of reports. You can select a suitable one under *Report Type*:

- **Table**: The default, most commonly used type of report. Many of the [example use cases for Confluence Cloud](https://appfire.atlassian.net/wiki/spaces/RFC/pages/477333214) generate table reports.
- **List **- An alternative to tables, list reports display data in bulleted rows.
- **Paragraph**: Paragraph reports display data in rows without bullets.
- **Grid**: Grid reports group data in three columns.

## Filling in the text for empty reports

Your queries may sometimes generate no results. You can add some error handling by filling out the *Empty Report* section. This text is shown if the report has no results.

For example, you can enter something like `No matching pages were found. Please try again later`. If left empty, the default text is *No Results*.

## Dynamic preview

The *Report Builder* includes a dynamic preview of the report you are building. You may need to scroll down to the bottom to view it.

The preview automatically refreshes if you change the report blocks, report type, query, expansions, or filters.

![dynamic_preview.png](media://5d132812-92de-4fc6-ac48-dfb7433ebc8d)