# Viewing quality profiles

For understand the concept of a quality profile, see the [understanding-quality-profiles](https://docs.sonarsource.com/sonarqube-server/quality-standards-administration/managing-quality-profiles/understanding-quality-profiles "mention") page.

## Retrieving quality profiles <a href="#retrieving-quality-profiles" id="retrieving-quality-profiles"></a>

In the top navigation bar of the SonarQube UI, select **Quality Profiles**. The **Quality Profiles** page opens with:

1. In the left-hand side: the list of profile sets by language.\
   Quality profiles inherited from a parent profile are displayed under their parent and with a left indent.\
   This list includes the following columns:
   * The **Projects** column shows the count of projects associated with a quality profile. Alternatively, it displays **`DEFAULT`** when the profile is the language’s default (any profile not explicitly associated with a quality profile is associated with the default profile).
   * The **Rules** column shows the total count of active rules within the profile. Additionally, if any of these active rules are deprecated, their number will also be indicated with a pink background.
   * The **Updated** column shows when the quality profile was last updated.
   * The **Used** column shows when the quality profile was last used during a project analysis.
2. In the right-hand side: different sections depending on the existing quality profiles:
   * The **Deprecated Rules** section lists the quality profiles that contain deprecated rules.
   * The **Recently Added Rules** section lists newly added rules and shows whether they are currently active in each profile.
   * The **Stagnant Profiles** section lists the custom profiles that have not been updated for more than one year.

<div align="left"><figure><img src="https://content.gitbook.com/content/3VWSqvZ4eaBLWvA6epdv/blobs/336MohxiKrVBDMbaloj0/09ffcee7abca388e8d81ac6b6fce9c786c156e8e.png" alt="The SonarQube UI displays information relating to your organization&#x27;s quality profiles."><figcaption></figcaption></figure></div>

## Viewing a quality profile <a href="#viewing-a-quality-profile" id="viewing-a-quality-profile"></a>

In the **Quality Profiles** page:

1. To view a specific language, select a language in **Filter by** at the top of the left-hand side list of quality profiles.
2. Select the quality profile you want to view. The quality profile is displayed as illustrated below.

<div align="left"><figure><img src="https://content.gitbook.com/content/3VWSqvZ4eaBLWvA6epdv/blobs/i9W9EUVWKrdRy631c6DU/15b27c8d43c5ce51f4cd1c9fadce603cd90aec64.png" alt="Once a quality profile is selected for viewing, SonarQube presents the profile&#x27;s inheritance status along with a Rule breakdown and list of Projects that use this profile."><figcaption></figcaption></figure></div>

The quality profile page includes the following sections:

1. **Inheritance**: shows the quality profile with its possible parent(s) and / or children. For each profile, the number of active, inactive, and overridden rules in the profile is shown. Select a number to view the corresponding list of rules.
2. **Projects**: shows the projects explicitly associated with the quality profile.
3. **Rule breakdown**: shows statistics about active and inactive rules contained in the quality profile. Select a statistic to view the corresponding rules.

If you have the Administer Quality Profiles permission, you will also see a **Permissions** section under the **Projects** section. The **Permissions** section shows the users and groups authorized to manage this quality profile.

## Comparing quality profiles <a href="#comparing-quality-profiles" id="comparing-quality-profiles"></a>

You can compare quality profiles of the same language.

To compare one profile with another:

1. In the SonarQube UI, retrieve one of the quality profiles you want to compare (quality-profile-1).
2. In the top right corner of the quality profile page, select the three-dot button, and select **Compare** in the menu. The comparison page opens.
3. In **Compare with**, select the profile to be compared to (quality-profile-2). The comparison results are displayed on the page as illustrated below. The left column corresponds to quality-profile-1 and the right column to quality-profile-2. In the comparison results, you can select a rule to inspect it.

![](https://content.gitbook.com/content/3VWSqvZ4eaBLWvA6epdv/blobs/faResAitOJDLHtu0NNag/29c4030efa22be63550ad2ca365da0ad57835e37.png)

In this example, the comparison reveals the following differences:

1. quality-profile-1 has 3 more rules and 2 fewer rules than quality-profile-2. These rules are listed in the respective column.
2. One rule has a different configuration in quality-profile-1 and quality-profile-2 (the severity level is different).

{% hint style="info" %}
The comparison doesn’t take into accounts the rule’s Prioritized option (supported from the Enterprise Edition).
{% endhint %}

## Viewing the overridden rules of a quality profile <a href="#viewing-overrridden-rules" id="viewing-overrridden-rules"></a>

A rule is considered overridden in a custom quality profile if this profile defines, for this rule, different parameters than its parent quality profile. The parameters may be severity level, rule’s configurable parameters, and, starting in [Enterprise Edition](https://www.sonarsource.com/plans-and-pricing/enterprise/), the Prioritized rule option.

To view the overridden rules of a quality profile:

1. Retrieve the quality profile as described above. The number of overridden rules in the profile (if any) is shown in the **Inheritance** section.
2. Select the **\<x> overridden rules** hyperlink. The list of overridden rules is displayed. In the list, you can only view the security level changes as illustrated below. To have more information, you can:
   * Compare the quality profile with its parent (see **Comparing quality profiles** above).
   * If you have the corresponding permission, select the **Change** button on the rule row.
   * Select the rule and navigate to the **Quality Profiles** section on the rule’s page. If the rule has configurable parameters, their values will be displayed in the section for each quality profile where the rule is active.

![](https://content.gitbook.com/content/3VWSqvZ4eaBLWvA6epdv/blobs/UVr5RxYH01AOEgY1LtqE/2893fdbc47472b55f57de754dba2a77c9d19f98e.png)

## Viewing the change history of a quality profile <a href="#viewing-change-history-of-quality-profile" id="viewing-change-history-of-quality-profile"></a>

1. Retrieve the quality profile as described above.
2. In the top right corner of the profile page, select **See Changelog**. The profile change history opens and lists the different actions performed on rules in the quality profile:
   * **Date**: action date.
   * **User**: user who performed the action.
   * **Action**: action type (the user activated, deactivated, or updated the rule).
   * **Rule**: rule on which the action was performed.
   * **Updates**:
     * For an Updated action: describes the update.
     * For an Activated action: shows the rule’s configurable parameter values (if any) at activation time.

![](https://content.gitbook.com/content/3VWSqvZ4eaBLWvA6epdv/blobs/awI24qFEiQ8Qq8vaVUBh/03dd824bf88202823c24afae3c058fffa120e415.png)

## Viewing the quality profiles associated with a project <a href="#viewing-quality-profiles-associated-with-project" id="viewing-quality-profiles-associated-with-project"></a>

1. See the instructions on the[viewing-projects](https://docs.sonarsource.com/sonarqube-server/user-guide/viewing-projects "mention") page to access your project.
2. In the top right corner of the project page, select **Project Information**. The **Project Information** page opens. The **About this Project** section shows the quality profiles used during the last analysis.
3. If you are a project admin, select **Project Settings** > **Quality profiles** to view the profiles configured for the project. If no profile is configured for a language, the built-in Sonar way profile is used for this language.

## Viewing the projects associated with a quality profile <a href="#viewing-projects-associated-with-a-quality-profile" id="viewing-projects-associated-with-a-quality-profile"></a>

The **Projects** section of a quality profile shows the projects associated with the profile. See **Retrieving a quality profile** above.

## Viewing the quality profiles where a rule is active <a href="#viewing-quality-profiles-where-a-rule-is-active" id="viewing-quality-profiles-where-a-rule-is-active"></a>

To view the quality profiles where a given rule is active:

1. Go to **Rules** and retrieve the rule.
2. In the rule page, navigate to the bottom to the **Quality Profiles** section. The section lists all quality profiles where the rule is active.

## Exporting a report on the quality profiles used in a project <a href="#exporting-report-on-used-quality-profiles" id="exporting-report-on-used-quality-profiles"></a>

You can export all rules contained in your quality profiles and used for the analysis of a given project branch by downloading the regulatory report. The data is included in the `quality-profiles.csv` file of the regulatory report’s ZIP file. See the [regulatory-reports](https://docs.sonarsource.com/sonarqube-server/user-guide/viewing-reports/regulatory-reports "mention") page for more information.

## Related pages <a href="#related-pages" id="related-pages"></a>

* [understanding-quality-profiles](https://docs.sonarsource.com/sonarqube-server/quality-standards-administration/managing-quality-profiles/understanding-quality-profiles "mention")
* [creating-a-quality-profile](https://docs.sonarsource.com/sonarqube-server/quality-standards-administration/managing-quality-profiles/creating-a-quality-profile "mention")
* [editing-a-custom-quality-profile](https://docs.sonarsource.com/sonarqube-server/quality-standards-administration/managing-quality-profiles/editing-a-custom-quality-profile "mention")
* [associating-a-quality-profile-with-projects](https://docs.sonarsource.com/sonarqube-server/quality-standards-administration/managing-quality-profiles/associating-a-quality-profile-with-projects "mention")
* [changing-default-quality-profile](https://docs.sonarsource.com/sonarqube-server/quality-standards-administration/managing-quality-profiles/changing-default-quality-profile "mention")
* [maintaining-your-custom-quality-profiles](https://docs.sonarsource.com/sonarqube-server/quality-standards-administration/managing-quality-profiles/maintaining-your-custom-quality-profiles "mention")
* [authorizing-other-users-to-manage-quality-profile](https://docs.sonarsource.com/sonarqube-server/quality-standards-administration/managing-quality-profiles/authorizing-other-users-to-manage-quality-profile "mention")
