Test your setup

Prerequisites

After completing configuration, verify your setup:

• trunk-io bot is added to push restrictions for your protected branch

• No branch protection rules apply to trunk-temp/* or trunk-merge/* branches

• If using Draft PR mode: Required status checks are configured in GitHub branch protection

• If using Push-triggered mode:

  • CI workflows trigger on trunk-merge/** branches

  • merge.required_statuses is defined in trunk.yaml

Test your configuration

1. Create a test pull request

2. Comment /trunk merge on the pull request

3. Check the Trunk Dashboard to monitor your pull request status

4. The pull request should appear in the queue as "Queued" until all checks complete

5. Click on the pull request in the dashboard to see detailed status of what it's waiting for

6. You'll also see status updates in the comments on your pull request

Expected behavior: Your pull request should progress through testing and merge automatically once all required checks pass.

Next Steps

🎉 Congratulations! Your Merge Queue is working. You're ready to use it with your team.

Start using Merge Queue

→ Submit and cancel pull requests - Learn how to use the queue day-to-day

Optimize your queue

Ready to make it even better? Explore these optimizations

→ Predictive Testing - Prevent queue collapse and increase throughput

→ Batching - Merge multiple PRs together for faster processing

→ Priority merging - Fast-track urgent PRs

→ Anti-flake protection - Handle flaky tests automatically

Configure integrations

→ Slack integration - Get notifications in Slack

→ Metrics and monitoring - Track your queue's performance

Having trouble? See our Troubleshooting guide for common installation issues.