CI Quality Gate

The CI Quality Gate allows you to define criteria that determine whether a Continuous Integration (CI) build passes or fails based on the issues it contains. This replaces custom scripting and aligns CI/CD workflows with consistent, built‑in validation.

When a CI build is loaded into a project, Validate automatically evaluates the build against the configured Quality Gate query. If any issues match the query, the build is marked Quality Gate: Failed.

The Quality Gate applies only to CI builds (those created with --ci-build).

You can configure the Quality Gate at the project and stream level, and set it through Validate, command line (kwadmin/validate admin), or the Web API.

How the CI Quality Gate works

A Quality Gate is defined using the same search syntax used on the Issues page (for example, taxonomy filters, status filters, reference filters). If the entered Quality Gate value contains restricted terms or unsupported characters, a suggestion message appears beneath the field to guide the user.

Validate evaluates each incoming CI build:

• PASSED: No issues match the query.

• FAILED: One or more issues match the query.

• NOT SET: No quality gate is configured; no status or pill is shown.