> ## Documentation Index
> Fetch the complete documentation index at: https://docs.entire.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Review and Require Checks

> Review CI results in plugin gates and choose which builds must pass before merging.

To see the CI results for a change, open its Trail. Each vendor reports a **check suite** for a workflow or build. Depot also reports **check runs** for individual jobs; Buildkite does not report step details yet.

For repositories that use a CI plugin, results appear in the plugin's own line under **Gates**. This applies to both repositories hosted on Entire and repositories mirrored from GitHub. The separate **Checks** gate is available only on GitHub mirrors.

The suite reports the overall outcome. It can remain pending after some jobs pass because the vendor still has work to finish. Open the vendor's build details, when available, to read logs and investigate failures.

## Require Checks Before Merging

For CI plugin gates, any failed build blocks merging by default when **Required checks** is empty. A build that has not reported any results does not block merging in this configuration. Populate the field only if you want to block on specific build types:

1. Open the repository in entire.com and go to **Settings** then **Gates**.
2. Find the gate for your CI plugin.
3. To block only on specific build types, set **Required checks** using the names described below.

[Configure the Checks gate and required checks](https://customer-0x5hsk8lh27fm00g.cloudflarestream.com/02219a4c9f9e53e95ea9a71000ab4d48/iframe)

### Buildkite

Name the pipeline in `org/pipeline` format. For example, to require the `tests` pipeline in the `acme` organization, enter `acme/tests`.

### Depot

Copy the full check name shown on the Trail for the workflow or individual job you want to require. For example, the job in the screenshot below is reported as `push:ci.yml / ci.yml:checks`. Enter that full name in **Required checks**; entering only `checks` will not match.

![Depot CI plugin gate on an Entire-hosted repository's Trail showing one of one checks passed](https://mintcdn.com/entire/mLuNv5SexCtqUE8w/images/ci-depot-plugin-trail.png?fit=max\&auto=format\&n=mLuNv5SexCtqUE8w\&q=85\&s=1a8159375c1418af17e09283b45aae03)

Depot plugin on Trails, showing the Depot CI gate with its reported job passed.

Names must match the builds your plugin reports. If you rename a pipeline, workflow, or job, update its required name in the plugin's gate too.

### RWX

RWX reports one check for the whole run by default. Its default label starts with `RWX:` and includes the run definition file and trigger type. Custom status-check settings can change the name or group tasks into separate checks.

1. Push a change that triggers the RWX run, then open its Trail.
2. Expand **RWX** under **Gates** and copy the full reported check name.
3. In the repository's **Settings → Gates → RWX**, enter that exact name in **Required checks**.

Use the name reported in Entire rather than just the run filename or a task key such as `verify-checkout`. If you rename the run definition or change its status-check names, review the reported names and update **Required checks** to match. Keep status checks enabled in the RWX integration so results can reach the gate.

### GitHub Mirrors

A GitHub mirror can also use the **Checks** gate to require checks reported through GitHub. This gate is separate from the gates for installed CI plugins and is not available on repositories hosted directly on Entire.

![Expanded Checks gate on a GitHub mirror Trail showing nine passed GitHub checks](https://mintcdn.com/entire/mLuNv5SexCtqUE8w/images/ci-github-mirror-checks.png?fit=max\&auto=format\&n=mLuNv5SexCtqUE8w\&q=85\&s=a1ff5e0d6f61e302e8540606ef1be26c)

GitHub checks on a GitHub mirror Trail, with all nine checks passed.

The Checks gate reads checks from GitHub but doesn't use GitHub's branch protection rules. Name the checks you need in that gate. A named check that hasn't been reported fails once all other checks have finished, or earlier if another reported check fails while others are still running. If you leave the list empty, every reported GitHub check must pass instead.

## Understand the Result

Review the plugin's gate on the Trail to see whether its required builds have completed. Individual jobs can finish while the overall workflow or build is still running.

<video autoPlay loop muted playsInline poster="/images/videos/ci-check-passes.jpg">
  <source src="https://mintcdn.com/entire/yKSEaBtqgPAkqkkW/images/videos/ci-check-passes.mp4?fit=max&auto=format&n=yKSEaBtqgPAkqkkW&q=85&s=f61352ae7be1bdf3b46067a2eee1276e" type="video/mp4" />
</video>

The Depot CI gate on a Trail, from running to passed.

Entire evaluates requirements against the latest commit. A passing result from an earlier commit does not satisfy the requirement for a newer change.

When a plugin has names configured in **Required checks**, missing checks normally block merging. The exception is when Entire knows that the commit was pushed before the plugin was connected, those checks appear as **Not reported** and do not block merging.

If a required result is missing or pending, compare the Trail's latest commit with the vendor's build and confirm that the configured name matches the pipeline, workflow, or job that reports it.

All blocking gates must pass before you can merge, unless someone with bypass permission bypasses them.
