# Associating with projects

As a Quality Profile Administrator, you can explicitly associate a quality profile with projects.

As a project administrator, you can associate your project with quality profiles. See the [changing-quality-gate](https://docs.sonarsource.com/sonarqube-server/2025.5/project-administration/changing-quality-gate "mention") page.

To explicitly associate a quality profile with projects, or change the projects associated with a quality profile:

1. Go to the **Quality Profiles** page and retrieve the qualiy profile.
2. In the **Projects** section of the quality profile, select **Change projects**. The **Projects** dialog opens.
3. Select the tab you want to use:
   * The **With** tab shows the projects associated with this quality profile. Use this tab to remove associations.
   * The **Without** tab shows the projects not associated with this quality profile. Use this tab to associate projects.
   * The **All** tab shows all projects. Use this tab to associate all projects or remove all associations.
4. Use the Search field to filter the list of projects.
5. Select or unselect a project to associate the project or remove the association, respectively. In the **All** tab, select **Bulk Change** to select or unselect all projects.
6. If you’re in the **With** or **Without** tabs, select **Reload** to refresh the dialog with your changes.
7. Select **Close**.

<div align="left"><figure><img src="https://4159601124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8MaL7qHHph0mwB0jcBjB%2Fuploads%2Fgit-blob-bfaa052f7a0449ba944d3c7b2e3f4f200bc80d09%2F806041f552560d5012ccf1e2449fd4bc8dea8287.png?alt=media" alt="To change the list of projects associated with your SonarQube quality profile, select Change Projects. Then use the With, Without, and All filters to select projects individually." width="563"><figcaption></figcaption></figure></div>

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

* [viewing-quality-profiles](https://docs.sonarsource.com/sonarqube-server/2025.5/quality-standards-administration/managing-quality-profiles/viewing-quality-profiles "mention")
* [understanding-quality-profiles](https://docs.sonarsource.com/sonarqube-server/2025.5/quality-standards-administration/managing-quality-profiles/understanding-quality-profiles "mention")
* [viewing-quality-profiles](https://docs.sonarsource.com/sonarqube-server/2025.5/quality-standards-administration/managing-quality-profiles/viewing-quality-profiles "mention")
* [creating-a-quality-profile](https://docs.sonarsource.com/sonarqube-server/2025.5/quality-standards-administration/managing-quality-profiles/creating-a-quality-profile "mention")
* [editing-a-custom-quality-profile](https://docs.sonarsource.com/sonarqube-server/2025.5/quality-standards-administration/managing-quality-profiles/editing-a-custom-quality-profile "mention")[editing-a-custom-quality-profile](https://docs.sonarsource.com/sonarqube-server/2025.5/quality-standards-administration/managing-quality-profiles/editing-a-custom-quality-profile "mention")
* [changing-default-quality-profile](https://docs.sonarsource.com/sonarqube-server/2025.5/quality-standards-administration/managing-quality-profiles/changing-default-quality-profile "mention")
* [maintaining-your-custom-quality-profiles](https://docs.sonarsource.com/sonarqube-server/2025.5/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/2025.5/quality-standards-administration/managing-quality-profiles/authorizing-other-users-to-manage-quality-profile "mention")


---

# 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-server/2025.5/quality-standards-administration/managing-quality-profiles/associating-a-quality-profile-with-projects.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.