Managing your project's quality gate

Changing your project's default quality gate and other parameters or features impacting your quality gate.

Changing the quality gate applied to your project

The instance’s default quality gate is applied by default to your project. As a project administrator, you can apply other standards to your project. To do so:

  1. Retrieve your project. See Retrieving projects for more details.

  2. Select Project Settings > Quality Gate.

  3. Select Always use a specific Quality Gate, and select the quality gate in the list.

  4. Select Save.

Setting up the Sandbox feature for your project

If your instance admin has enabled the Sandbox feature in your instance, you can switch it on or off for your project, and, if allowed by the instance admin, you can change the sandbox conditions. For more information about this feature, see Issue management solution.

If you switch off the Sandbox feature for your project, any existing sandboxed issues will remain in the Sandbox and can still be triaged by users.

Switching Sandbox on or off

  1. Retrieve your project. See Retrieving projects for more details.

  2. In the top right corner, select Project Settings > General Settings > General.

  3. In Sandbox specific issue categories after SonarQube update, enable the Sandbox feature.

  4. Select Save.

In the project Settings, switch on or off the sandbox feature for your project

Changing the Sandbox conditions

If allowed by your instance admin, you can change the software quality and/or severity of issues moved to the Sandbox.

Proceed as follows:

  1. Retrieve your project.

  2. In the top right corner, select Project Settings > General Settings > General.

  3. In Sandbox specific issue categories after SonarQube update, make sure the sandbox feature is enabled.

  4. In Choose software quality and severity of issues automatically moved to sandbox after SonarQube update, change the software quality(ies) and/or severity(ies).

  5. Select Save.

  6. To reset the sandbox conditions to their default values, select Reset To Default.

Configuring the quality gate fudge factor

The quality gate fudge factor refers to a mechanism where conditions on duplication and coverage are ignored until the number of new lines is at least 20. This is used to avoid overly strict enforcement when dealing with small changes, as minor issues might disproportionately impact the overall quality gate status.

The fudge factor is enabled by default in your instance. This global setting is applied to all new projects. Project administrators can override it for their project.

You can enable the fudge factor in the UI as explained below, or by setting the sonar.qualitygate.ignoreSmallChanges property to false or true on the CI/CD host (see Analysis parameters).

To enable or disable the quality gate fudge factor in the UI for your project:

  1. Retrieve your project. See Retrieving projects for more details.

  2. Select Project Settings > General Settings > General.

  3. In the Quality gate section, unselect or select Ignore duplication and coverage on small changes.

Last updated

Was this helpful?