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

# Semgrep Managed Scans doesn't run for pull requests in GitHub merge queues

Your merge queue pipelines can become blocked if you:

* Use Semgrep Managed Scans to automatically scan your projects
* Use GitHub merge queues to automate pull request merges
* Have made the Semgrep scan a required check

Managed Scans do not run in merge queues, so the required Semgrep check never passes, preventing merges.

## Why Semgrep doesn't run in merge queues

Semgrep doesn't run in merge queues because:

* Diff-aware scans during a merge queue check aren't meaningful. The purpose of a diff-aware scan is to catch issues before code is merged. Pull requests in a merge queue are already approved for merged.
* Full scans take a long time, significantly delaying merges for larger repositories.

## Workaround

To keep Semgrep required for pull requests without blocking merge queues, define two separate [GitHub rulesets](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets#about-rulesets):

1. **Pull request ruleset for the main branch**: requires the Semgrep check to pass before merging
2. **Merge queue ruleset for the main branch**: does **not** require the Semgrep check. Instead, this uses a placeholder check that runs on `merge_group`.

### Define your rulesets

<Steps>
  <Step>
    Go to your GitHub repository.
  </Step>

  <Step>
    Go to **Setting > Code and automation > Rules > Rulesets**.
  </Step>

  <Step>
    Configure your rulesets:

    * **PR**: requires the Semgrep check to pass before merging.
    * **Queue**: does **not** require the Semgrep check
  </Step>
</Steps>

### Create a placeholder workflow

Define a workflow to provide a passing check for merge queue events:

```yaml theme={null}
# .github/workflows/semgrep-mq-placeholder.yml
name: Semgrep - merge queue placeholder

on:
   merge_group: {}
   workflow_dispatch: {}
   pull_request: {}

jobs:
   semgrep-mq-placeholder:
      name: semgrep-cloud-platform/scan   # this is the name required in the MQ ruleset
      runs-on: ubuntu-latest
      timeout-minutes: 3
      steps:
         - run: echo "OK – Semgrep already ran on the PR; MQ can proceed."
```

## Example walkthrough

Watch this [Loom recording](https://www.loom.com/share/57e7288e1c5b4b22b6386e5c49953381) to see a walkthrough of the workaround.