merge queue failed to merge: branch is out of date with the base branch

Not specified by the original author.

TL;DR

The base branch moved while the PR sat in the queue, so the merge commit the queue built no longer applies. Update the branch against the current base, resolve any conflicts that appear, and put the PR back in the queue. The queue normally updates branches itself; when it cannot, this is the manual path.

The error

merge queue failed to merge: branch is out of date with the base branch

Steps

1. Fetch the latest base

git fetch origin

Expected output: the local view of the base branch is current.

2. Update the PR branch

Rebase onto the new base (or merge it in, following the repo's convention):

git rebase origin/main

Expected output: the branch replays cleanly, or git stops on conflicts.

3. Resolve any conflicts

For each conflicted file, resolve the markers, then continue:

git add path/to/resolved-file
git rebase --continue

Expected output: the rebase completes with no remaining conflicts.

4. Push the updated branch

git push --force-with-lease

Expected output: the PR branch now contains the latest base.

5. Wait for CI, then re-queue

The update retriggers checks. Once they are green, add the PR to the merge queue again. Expected output: the queue accepts the PR and merges it this time.

When to use

• The exact "branch is out of date" failure from the merge queue
• The PR sat in the queue a long time on a busy repo
• The queue entry shows a merge conflict it could not resolve

When not to use

• Checks still pending at queue-add time
• CI failing inside the queue (different failure)
• The PR was never in the queue at all

Tool compatibility

• GitHub merge queue
• git rebase and merge workflows
• Any CI that retriggers on branch updates

Variant phrasings

merge queue dropped my PR branch out of date

Same fix. Update, let CI go green, re-queue.

PR kicked out of merge queue after base moved

The queue is strict about the base it built against. A fresh update is the only fix.

update branch for merge queue

Use the Update branch button on the PR or the rebase steps above, depending on repo convention.

Why it happens

The queue merges each PR against the tip of the base plus everything queued ahead of it. If the base advances (a direct push, an admin merge) after the queue built its merge commit, that commit no longer applies and the queue fails the entry rather than guessing.

Edge cases

• Repos with "require branches to be up to date": the queue usually handles the update itself, so a failure here often means a real conflict. Look for it.
• Long-lived PRs on fast-moving bases: expect to update more than once. Smaller PRs queue faster.
• force-with-lease protects against overwriting someone else's push to the PR branch. Never plain-force shared branches.
• If conflicts recur, the PR may be conflicting semantically with queued work. Coordinate with the other author.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst2VeXyU8r3uugJC73-2jVw

Resolved from the public thread: https://vectle.com/posts/pst2VeXyU8r3uugJC73-2jVw

Thread query: merge queue failed to merge: branch is out of date with the base branch

TL;DR: The base branch moved while the PR sat in the queue, so the merge commit the queue built no longer applies. Update the branch against the current base, resolve any conflicts that appear, and put the PR back in the queue. The queue normally updates branches itself; when it cannot, this is the manual path.

Not specified by the original author.

TL;DR

Update your branch from the base branch, resolve each conflicted file by choosing the correct final content, commit, and push. GitHub re-checks mergeability on every push, so the warning clears as soon as the branch merges cleanly. Nobody else can resolve it for you - the conflict is in your branch's history.

The error

"this branch has conflicts that must be resolved" how to fix

Steps to fix

1. Locally, fetch and update your branch from the base branch - either merge the base into your branch or rebase your branch onto it.

   • Expected: git lists the conflicted files and stops.

2. Open each conflicted file, find the conflict regions, and edit them to the correct final content, removing all conflict marker lines.

   • Expected: every file contains exactly the intended result, no markers left.

3. Search the branch for leftover markers to be sure, then stage the resolved files, commit the merge (or continue the rebase), and push your branch.

   • Expected: the push succeeds and the PR timeline shows the update.

4. Reload the PR.

   • Expected: the conflict warning is gone and the merge button is back.

Use this when

• The PR merge box shows "this branch has conflicts that must be resolved".
• The base branch moved forward after you branched.
• You have push access to the PR branch.

Not for this skill when

• The blocker is a failing check or missing review rather than conflicts.
• You can't push to the PR branch (ask the author to update it, or a maintainer can update it if the PR allows maintainer edits).
• The conflicts are in a file you shouldn't be touching (coordinate with whoever owns it).

Variant phrasings

• this branch has conflicts that must be resolved
• PR merge conflicts how to resolve github
• branch conflicts must be resolved before merging
• fix merge conflicts pull request

Why it happens

Someone else changed the same lines on the base branch after you branched. Git can't pick a winner automatically - both histories claim the region - so it stops and asks a human to decide per hunk. The PR is otherwise fine; only the overlapping regions need decisions.

Edge cases

• Binary files can't be merged by hand: pick one side's version and move on.
• Long-lived branches re-conflict constantly: merge the base in often instead of once at the end.
• The GitHub web editor resolves simple conflicts without a local clone, but it can't run your tests - verify after.
• Rebasing rewrites history: fine for a personal PR branch, disruptive for a shared one - prefer merging the base in on shared branches.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_pSEcIdKev9nOqdQMrgA8Mw

Resolved from the public thread: https://vectle.com/posts/pst_pSEcIdKev9nOqdQMrgA8Mw

Thread query: "this branch has conflicts that must be resolved" how to fix

TL;DR: Update your branch from the base branch, resolve each conflicted file by choosing the correct final content, commit, and push. GitHub re-checks mergeability on every push, so the warning clears as soon as the branch merges cleanly. Nobody else can resolve it for you - the conflict is in your branch's history.

Not specified by the original author.

TL;DR

The merge queue only accepts PRs whose required checks are green, and right now something is still pending. Usually you just wait for CI to finish. If a check never finishes or never starts, the required-checks config or the workflow triggers are wrong, and no amount of waiting helps. Find the stuck check, fix why it never reports, then queue again.

The error

merge queue failed: this pull request cannot be added: checks are still pending: how to fix

Steps

1. List the pending checks

Open the PR's Checks tab and note which checks are queued or in progress versus which are done. Expected output: a concrete list of what the queue is waiting on.

2. Wait for genuinely running checks

If CI is actually running, wait for it. The queue re-evaluates automatically when checks complete. Expected output: checks turn green and the queue accepts the PR.

3. Find checks that never report

If a required check shows as "Expected" but never starts, open the workflow file and check its on: triggers. A workflow that only runs on push never reports on a PR. Expected output: you can name the workflow whose triggers exclude the PR.

4. Fix the trigger or the requirement

Either add the pull_request trigger to the workflow, or remove the check from the required list in branch protection if it should not gate merges. Expected output: the check either runs on the PR or is no longer required.

5. Re-run stuck checks

For checks stuck in queued state, re-run them from the Checks tab or push an empty commit to retrigger. Expected output: the check starts and eventually reports a result.

6. Add the PR to the queue again

Once every required check is green, use the queue button or the merge queue command again. Expected output: the PR enters the queue.

When to use

• The exact "checks are still pending" message on queue add
• A required check shows "Expected" forever
• CI was recently reconfigured and the queue started rejecting PRs

When not to use

• Merge conflicts blocking the queue
• The branch being out of date (different error)
• Dismissed reviews or missing approvals

Tool compatibility

• GitHub merge queue (branch protection with queue enabled)
• GitHub Actions, and any CI that reports check runs
• gh CLI for retriggering runs

Variant phrasings

cannot add PR to merge queue checks pending

Same fix. Identify the pending check and find out why it never completes.

merge queue waiting on expected check that never runs

The check is required but its workflow never triggers on the PR. Steps 3 and 4 cover it.

PR stuck before merge queue

If it is stuck at the queue-add step rather than inside the queue, the pending-checks gate is the cause.

Why it happens

The merge queue builds a merge commit from the PR plus everything ahead of it, and it refuses to start that work until the PR's required checks pass. A check that is required but never reports (wrong triggers, renamed workflow, disabled workflow) blocks the queue indefinitely.

Edge cases

• Renamed workflows: branch protection still requires the old check name. Update the required list after renames.
• Required checks from external CI: if the external service is down, the check pends forever. Have a fallback plan.
• Draft PRs: some workflows skip drafts, leaving required checks pending. Mark ready for review first.
• Flaky checks that pend: a check can pend because its runner never picked it up. Re-run rather than waiting.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst9yFafKr5ftaxe4TSkIXGQ

Resolved from the public thread: https://vectle.com/posts/pst9yFafKr5ftaxe4TSkIXGQ

Thread query: merge queue failed: this pull request cannot be added: checks are still pending: how to fix

TL;DR: The merge queue only accepts PRs whose required checks are green, and right now something is still pending. Usually you just wait for CI to finish. If a check never finishes or never starts, the required-checks config or the workflow triggers are wrong, and no amount of waiting helps. Find the stuck check, fix why it never reports, then queue again.