---
url: /howto/creating-quality-report.md
---

# Creating a Quality Report in Teamscale 

Starting with version 5.6, Teamscale allows to create **quality reports** for one or more projects.
A report is a presentation-like format to track quality changes over a specific time span, e.g., a release cycle.
To create a report, the [Reports perspective](../../reference/ui/qualitycontrol/reports/) has been integrated into Teamscale.

\[\[toc]]

## Prerequisites for Creating a Report

In order for a user to be able to create new reports, **all of** the following conditions have to be fulfilled:

1. The user has been granted a *Global Role* that contains the *Create Quality Reports* permission (contained by default in the *Project Creator* and *Instance Admin* global roles).
2. The user has been granted any *Project Role* that contains the *View Project* permission for at least one project in the Teamscale instance.
3. The user has been granted at least the *Viewer Role* for at least one *threshold configuration* in the Teamscale instance.

## Configuring a New Report

Within the Reports perspective, a new report can be created by clicking on the `+ New Report` button.
The New Report dialog allows specifying general report settings:

![New Report Dialog](./quality-report-new-dialog.png)

Clicking `New Report` will open your new report in the Report Editor.

## Editing your Report

After its initial creation, the report contains only the title slide.
In the Report Editor, you can:

* add new slide using the  at the bottom of the left pane.
* edit the current slide by clicking `Configure slide` in the top left corner.

:::tip More on Slides & Options
Please refer to the [report slides reference](../../reference/ui/qualitycontrol/reports/slideoverview/) and  [options reference](../../reference/ui/qualitycontrol/reports/#changing-the-settings-of-a-slide) for an overview
:::

## Saving your Report

:::tip Auto-Save
A quality report in Teamscale is automatically saved after a change was made while you are in the Report Editor.
:::

You can also click the `Save & Close` button to save and leave the editor.

## Presenting your Report

To present your report in fullscreen, simply click the  icon next to the report's name in the overview.
Within the editor, you can do this by choosing  `Start` from the bottom bar.