PDF reports

PDF reports are available as part of the Enterprise Edition and above.

PDF reports give a periodic, high-level overview of the code quality and security of your projects, applications, or portfolios.

The reports focus mainly on new code and quality gate conditions. This means that, if there are failing conditions on the overall code, they will appear in the report as well.

Project and application PDF reports

From each project or application's homepage, you can download PDF reports from the drop-down menu in the upper right corner and subscribe to regular updates. The frequency with which you receive reports is set by a project or application administrator.

Changing PDF subscription frequency for projects and applications

Users with administrative rights on a project or application can configure how frequently SonarQube sends PDF reports. You can change the frequency of all projects and applications at a global level or for each project or application individually:

• Global-level:To change the frequency setting globally, navigate to Administration > General Settings > Governance. Under Project and Application PDF Reports, select an option from the PDF Reports Frequency drop-down menu.
• Project-level: To change the frequency setting for a specific project, navigate to the project's home page then Project Settings > General Settings > Governance. Under Project and Application PDF Reports, select an option from the PDF Reports Frequency drop-down menu.
• Application-level: To change the frequency setting for a specific application, navigate to the application's home page then Application Settings > Application Report Settings, and select an option from the Application Reports Frequency drop-down menu.

You have the following options for subscription frequency:

• Daily 
• Weekly 
• Monthly (default)

Temporary branches

You cannot download or subscribe to a PDF report for a temporary branch. If you are unable to download or subscribe to a PDF report for a branch, go to Project Settings > Branches and Pull Requests and make sure that the Keep when inactive toggle is on for that branch.

Portfolio PDF reports

Users with access to a portfolio can download a PDF report or subscribe to receive PDF reports from the Portfolio PDF Report drop-down menu in the upper-right corner of the portfolio's home page. 

The frequency with which you receive reports is set by a portfolio administrator. See the following section for more information.

Changing PDF subscription frequency for portfolios

Users with administrative rights on a portfolio can configure how frequently SonarQube sends PDF reports. You can change the frequency for all portfolios globally or for each portfolio individually.

• Global-level: To change the frequency setting at a global level, navigate to Administration >  General Settings > Governance, and in the Portfolio PDF Reports section, select a frequency from the drop-down menu.
• Portfolio-level: To change the frequency setting for a specific portfolio, navigate to the portfolio's home page then Portfolio Settings > Executive Report and select an option under Frequency.

You have the following options for subscription frequency:

• Daily: report is sent during the first portfolio calculation of the day (if any)
• Weekly: report is sent during the first portfolio calculation of the week (if any) from Monday
• Monthly (default): report is sent during the first portfolio calculation of the month (if any), starting from the first day of the current month

Sending portfolio PDF reports to non-SonarQube users

Users with administrative rights on a portfolio can send the portfolio PDF report to non-SonarQube users by adding their email in the Other Recipients field at Portfolio Settings > Executive Report.

Regulatory reports

Users with access to a project can download a regulatory report for any permanent branch of that project. A permanent branch is one that has been set to Keep when inactive (see Branch analysis for details on how to adjust this setting).

To download the regulatory report, go to Project Information > Regulatory Report, select the desired branch and click the Download button; the report will be dynamically generated and downloaded and may take a few minutes depending on the project size.

The report is a zip file containing a snapshot of the selected branch. It is comprised of a selection of .txt, .csv, and .pdf files containing:

• An overview of the selected branch of the project.
• Configuration items relevant to the project's quality (quality profile, quality gate, and analysis exclusions).
• Lists of findings for both new and overall code on the selected branch.

Security reports

Security reports can also be downloaded as PDF. For more information, please see our page in the User guide explaining Security reports in detail.