# Maintaining quality profiles

You should regularly maintain your organization’s custom quality profiles *that do not inherit from a built-in profile*. The built-in quality profiles are regularly updated to reflect the addition of new rules and the deprecation of existing ones. As a user with Administer Quality Profile permission, you will be notified by email each time a built-in profile is updated. Updates can be introduced through a SonarQube or third-party analyzer upgrade.

To edit a custom quality profile, you need the Administer Quality Profiles permission in your organization or be authorized to manage this particular profile. To delete a custom quality profile, you need the Administer Quality Profiles permission.

## Ensuring your quality profile has all relevant new rules <a href="#ensuring-quality-profile-has-relevant-new-rules" id="ensuring-quality-profile-has-relevant-new-rules"></a>

To ensure that your custom quality profile has all relevant new rules, you can check for the recently added rules and for the stagnant profiles. Stagnant profiles are custom profiles that have not been updated for more than one year.

### In the Quality Profiles page <a href="#in-the-quality-profiles-page" id="in-the-quality-profiles-page"></a>

To check for recently added rules and stagnant profiles:

1. [Retrieving your organizations](/sonarqube-cloud/getting-started/viewing-organizations.md) and go to **Quality profiles**. The right-hand side of the **Quality Profiles** page shows the stagnant profiles and recently implemented rules.
2. To inspect a new rule, select it in the **Recently Added Rules** section.

<div align="left"><figure><img src="/files/UmOjBGxJ6kDr9zc56D6I" alt="Stagnant Profiles and Recently Added Rules section on the Quality Profiles page"><figcaption></figcaption></figure></div>

3. To edit a stagnant profile, select it in the **Stagnant Profiles** section. The quality profile page opens. To add the new rules to your profile, you can now:
   1. Either select **\<X> inactive rules** in the **Inheritance** section and then activate the new rules from the list of inactive rules.
   2. Or compare the stagnant profile with the built-in profile.

### In the Rules page <a href="#in-the-rules-page" id="in-the-rules-page"></a>

To check for recently added rules:

1. See [Retrieving your organizations](/sonarqube-cloud/getting-started/viewing-organizations.md) to access your organization, then go to the **Rules** page.
2. In **Filters**, set the **Available Since** criterion.

## Managing the deprecated rules in quality profiles <a href="#managing-deprecated-rues-in-quality-profiles" id="managing-deprecated-rues-in-quality-profiles"></a>

A deprecated rule is a rule that SonarQube will not be supported any more in the near future. A rule may be deprecated if it has become obsolete or if it has been replaced by one or several new rules. When a rule becomes deprecated, it will be deactivated in the corresponding language’s built-in profile and in the profile inheriting from it.

If your custom profile does not inherit from the built-in profile, you should regularly check your quality profiles for deprecated rules as follows:

1\. See [Retrieving your organizations](/sonarqube-cloud/getting-started/viewing-organizations.md) to access your organization, then go to the **Quality Profiles** page. On the right-hand side of the page, the **Deprecated Rules** section lists the quality profiles containing deprecated rules.

2\. To manage one of these profiles, select the **\<X> rules** hyperlink under the profile name. The list of deprecated rules in the profile is displayed.

3\. To deactivate a rule, select the respective **Deactivate** button. To deactivate all rules at a time, select **Bulk Change** > **Deacivate in <**&#x59;OUR PROFIL&#x45;**>** in the top tool bar.

## Deleting a quality profile <a href="#deleting-a-quality-profile" id="deleting-a-quality-profile"></a>

To delete a custom quality profile:

1. Retrieve your organization. See [Retrieving your organizations](/sonarqube-cloud/getting-started/viewing-organizations.md) for details.
2. Go to **Quality Profiles.**
3. Retrieve the custom quality profile you want to delete.
4. In the top right corner of the quality profile page, select the three-dot button and select **Delete** in the menu. A confirmation dialog opens.
5. Select **Delete**.

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

* [Viewing quality profiles](/sonarqube-cloud/standards/managing-quality-profiles/viewing-quality-profiles.md)
* [Understanding quality profiles](/sonarqube-cloud/standards/managing-quality-profiles/understanding-quality-profiles.md)
* [Viewing quality profiles](/sonarqube-cloud/standards/managing-quality-profiles/viewing-quality-profiles.md)
* [Creating a quality profile](/sonarqube-cloud/standards/managing-quality-profiles/creating-a-quality-profile.md)
* [Editing a quality profile](/sonarqube-cloud/standards/managing-quality-profiles/editing-a-custom-quality-profile.md)
* [Associating with projects](/sonarqube-cloud/standards/managing-quality-profiles/associating-a-quality-profile-with-projects.md)
* [Changing default quality profile](/sonarqube-cloud/standards/managing-quality-profiles/changing-default-quality-profile.md)
* [Granting permissions to users](/sonarqube-cloud/standards/managing-quality-profiles/authorizing-other-users-to-manage-quality-profile.md)
* [Quality profile](/sonarqube-cloud/managing-your-projects/project-analysis/quality-profile-association.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sonarsource.com/sonarqube-cloud/standards/managing-quality-profiles/maintaining-your-custom-quality-profiles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.