Skip to main content

Documentation Index

Fetch the complete documentation index at: https://trunk-4cab4936-mintlify-migrate-trunk-docs-1778256504.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Troubleshooting common issues

Visit Trunk Support for additional assistance or to contact the support team.
If your test PR doesn’t merge automatically:
  • Check the status comments for the PR in the Trunk Dashboard to see what it’s waiting for
  • Stuck in “Queued”: Usually means branch protection rules haven’t passed (missing required status checks or code review) or there are merge conflicts. If the status looks correct but the PR still won’t enter the queue, try removing and re-adding by commenting /trunk merge again on the PR.
  • Fails when attempting to merge: Check that squash merges are enabled for your repository in GitHub settings (Settings > General > Allow squash merging). Trunk Merge Queue requires squash merges to be enabled.
  • “Permission denied” errors: Review the Branch Protection guide to ensure trunk-temp/* and trunk-merge/* branches aren’t protected by wildcard rules like */*.
  • Status checks not running: Verify your CI is configured to run on draft PRs (or trunk-merge/** branches if using push-triggered mode). See the Branch Protection guide for details.

Troubleshooting common issues