> For the complete documentation index, see [llms.txt](https://help.qonic.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.qonic.com/documentation/qonic-dashboard/reports.md).

# Reports

Reports can be created from a model to generate precise quantity takeoffs based on grouping and filtering rules.

## Creating a report

To define a new report, open a model and use the [Report Panel](https://help.qonic.com/documentation/qonic-application/data-and-collaboration/report-panel.md) to define the structure of your report. Once the report is set up in the model environment, save it to the project dashboard by clicking Export Report.

To create or update reports, you need at least the status of **Editor** in the project and **Model Editor** access rights on the model(s) (see [Model Access Rights](https://help.qonic.com/documentation/qonic-dashboard/models/model-access-rights.md)).

<div data-with-frame="true"><figure><img src="https://929210962-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZKeCFTBZzqUt4lpmhUdS%2Fuploads%2Ffd65nFkAYwMsOWS1Mym5%2Fimage.png?alt=media&amp;token=abec3c74-17e8-4d46-9f90-e5e13b645d30" alt=""><figcaption></figcaption></figure></div>

## Using reports

Once a report has been created, it can be double-clicked to open, or you can select it and click *Open*. A report can be opened once its quantities have been calculated. You can view the entities that each row relates to by clicking the *View in model* button in the right-most column.

<div data-with-frame="true"><img src="https://20430882.fs1.hubspotusercontent-na1.net/hubfs/20430882/image-png-Dec-20-2024-12-51-41-2757-PM.png" alt="" height="539" width="688"></div>

If a quantity can be shown in several units or measurements, use the dropdown in the *Unit* or *Measurement* column of that row to switch between them.

To export a report to a .csv file, select it in the Reports tab and click *Export CSV* (or right-click it and choose *Export CSV*). You can export one report at a time, once its quantities have been calculated.

## Updating a report

Each time a new version of a model is created (see [Model Versions](https://help.qonic.com/documentation/qonic-dashboard/models/model-version-management.md)), you need to update the report to see these changes. Click *Update* at the top-left of the report. This button is only available if you are at least an Editor in the project.

In the *Create a new report* dialog, check the name (by default the model name followed by *Copy*, or *Multi Model Copy* for a report on several models) and click *Update*. Qonic creates a new report with the same structure, calculated on the latest version of the model(s). The original report stays in the list, so you can compare the two. If you no longer need the original report, a project owner can delete it.

In the updated report, the *Quantity* column shows the previous value below the new one, with an arrow and the difference when the quantity changed. Exported .csv files include the previous values as well.

<img src="https://20430882.fs1.hubspotusercontent-na1.net/hubfs/20430882/image-png-Feb-19-2024-03-47-44-3740-PM.png" alt="" height="55" width="284">

## Managing reports

In the Reports tab, select a report to open or export it, or select one or more reports to delete them. You can also right-click a report for the same actions. Only project owners can delete reports. Use the controls at the top right to search, sort (by name, creation date or last update), group (by creator or model name) or filter by model tag.
