From dad909683189f5f48c9a364ca730ea516752edd6 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 14 May 2026 18:10:05 +0000 Subject: [PATCH] docs(merge-queue): document configurable label commands for enqueueing Documents the Label Commands setting (trunk2 PR #3956, ships in v175): - enqueueing by label as a submission method - how to enable and configure the enqueueing label in Settings - the apply/remove behavior table https://github.com/trunk-io/trunk2/pull/3956 Co-Authored-By: Claude Opus 4.6 --- merge-queue/using-the-queue/reference.md | 27 ++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/merge-queue/using-the-queue/reference.md b/merge-queue/using-the-queue/reference.md index 54d9d7bc..1367e763 100644 --- a/merge-queue/using-the-queue/reference.md +++ b/merge-queue/using-the-queue/reference.md @@ -20,6 +20,8 @@ trunk login trunk merge ``` +* Applying the configured enqueueing label to a pull request (when label commands are enabled — see [Label Commands](#label-commands) below). + Admins can also use [`/trunk merge --force`](force-merge.md) to push a PR through the queue when branch protection isn't satisfied. We offer similar commands for cancellation. @@ -36,6 +38,31 @@ trunk login trunk merge cancel ``` +* Removing the configured enqueueing label from a pull request (when label commands are enabled). + +## Label Commands + +Label Commands let you enqueue and cancel PRs in the Merge Queue by applying or removing a GitHub label, without leaving a comment or using the CLI. + +### Enabling Label Commands + +Label Commands are configured per merge queue instance in **Merge Queue Settings** > **Label Commands**. Only organization admins can change this setting. + +When Label Commands are enabled, you can configure the enqueueing label name. The default label is `trunk-merge-queue-submit`. + +### How it works + +| Action | Effect | +| ------ | ------ | +| Apply the enqueueing label to a PR | Submits the PR to the Merge Queue | +| Remove the enqueueing label from a PR | Cancels the PR from the queue | + +The label must already exist in your GitHub repository. Trunk does not create the label automatically. + +{% hint style="info" %} +Label Commands work alongside comment commands and the Trunk web app. You can use any combination of submission methods; they all target the same queue. +{% endhint %} + ## Custom merge commit titles You can specify a custom merge commit title for any PR by adding a `merge-commit-title:` directive on its own line anywhere in the PR body: