From 7a237c902fe22654f4c4d00f2fb573b847892781 Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 26 Jun 2026 12:07:24 +0000 Subject: [PATCH] docs(merge-queue): changelog for Stale PR Timeout setting Adds changelog entry and settings reference for the new Stale PR Timeout (notReadyTimeoutHours) setting shipped in trunk2 PR #4253. Co-Authored-By: Claude --- .../2026-06-25-merge-queue-stale-pr-timeout.mdx | 15 +++++++++++++++ changelog/index.mdx | 6 ++++++ docs.json | 1 + merge-queue/administration/advanced-settings.mdx | 14 ++++++++++++++ merge-queue/changelog.mdx | 6 ++++++ 5 files changed, 42 insertions(+) create mode 100644 changelog/2026-06-25-merge-queue-stale-pr-timeout.mdx diff --git a/changelog/2026-06-25-merge-queue-stale-pr-timeout.mdx b/changelog/2026-06-25-merge-queue-stale-pr-timeout.mdx new file mode 100644 index 00000000..cd19c481 --- /dev/null +++ b/changelog/2026-06-25-merge-queue-stale-pr-timeout.mdx @@ -0,0 +1,15 @@ +--- +title: "Merge Queue: Stale PR Timeout" +description: "Set a configurable timeout to automatically cancel not-ready PRs that have been waiting to enter the queue." +date: 2026-06-25 +category: Merge Queue +type: feature +--- + +**PRs that stay in a not-ready state too long can now be cancelled automatically.** + +A new **Stale PR Timeout** setting in Merge Queue Settings lets you configure how long a PR can wait to enter the queue after being submitted before it is automatically cancelled. The timeout is configured in days and hours. Setting it to 0 disables the timeout entirely. + +A PR is in a not-ready state when it has been submitted to the queue but is waiting to meet required checks or branch protection rules before the queue will begin testing it. If the PR remains in this state past the configured timeout, Trunk cancels it. Authors who have set up [personal Slack DMs](/merge-queue/integration-for-slack#personal-slack-notifications) receive a direct notification when this happens. + +This setting is admin-only, like all other Merge Queue settings. See [Settings and configurations](/merge-queue/administration/advanced-settings#stale-pr-timeout) for configuration details. diff --git a/changelog/index.mdx b/changelog/index.mdx index 0663e359..6e2db07b 100644 --- a/changelog/index.mdx +++ b/changelog/index.mdx @@ -14,6 +14,12 @@ rss: true The Trunk browser extension 0.13.0 ships performance improvements and bug fixes. + + **[Merge Queue: Stale PR Timeout](/changelog/2026-06-25-merge-queue-stale-pr-timeout)** + + Set a configurable timeout to automatically cancel not-ready PRs that have been waiting to enter the queue. + + **[Merge Queue: Queue and Graph Tabs Now Refresh on Return](/changelog/2026-06-18-merge-queue-stale-tab-refresh-fix)** diff --git a/docs.json b/docs.json index 37e3fce6..2e470720 100644 --- a/docs.json +++ b/docs.json @@ -625,6 +625,7 @@ "group": "June", "pages": [ "changelog/2026-06-29-browser-extension-0-13-0", + "changelog/2026-06-25-merge-queue-stale-pr-timeout", "changelog/2026-06-18-merge-queue-stale-tab-refresh-fix", "changelog/2026-06-17-flaky-tests-browser-extension-failure-details", "changelog/2026-06-17-merge-queue-metrics-and-extension-updates", diff --git a/merge-queue/administration/advanced-settings.mdx b/merge-queue/administration/advanced-settings.mdx index 25fb7add..d159524c 100644 --- a/merge-queue/administration/advanced-settings.mdx +++ b/merge-queue/administration/advanced-settings.mdx @@ -187,6 +187,20 @@ For example, assuming a timeout of 4 hours: *** +## Stale PR Timeout + +> Set the timeout in days and hours, or keep at **0 (Off)** to disable. Default is **Off**. + +Configure how long a PR can wait to enter the queue after being submitted before it is automatically cancelled. When a submitted PR is not ready (waiting for required checks or branch protection rules to pass before the queue will admit it) and remains in that state past the configured duration, Trunk cancels it and notifies the author via Slack DM if they have [personal notifications](/merge-queue/integration-for-slack#personal-slack-notifications) configured. + +Setting the timeout to 0 disables it entirely; PRs in a not-ready state will wait indefinitely until manually cancelled or until they become ready. + + +Organization admin access is required to change this setting. + + +*** + ## Required Status Checks > Configure which CI status checks must pass before a PR can merge through the queue. diff --git a/merge-queue/changelog.mdx b/merge-queue/changelog.mdx index f6f16863..3c546e84 100644 --- a/merge-queue/changelog.mdx +++ b/merge-queue/changelog.mdx @@ -15,6 +15,12 @@ og:title: "Trunk Merge Queue changelog" The Trunk browser extension 0.13.0 ships performance improvements and bug fixes. + + **[Merge Queue: Stale PR Timeout](/changelog/2026-06-25-merge-queue-stale-pr-timeout)** + + Set a configurable timeout to automatically cancel not-ready PRs that have been waiting to enter the queue. + + **[Merge Queue: Queue and Graph Tabs Now Refresh on Return](/changelog/2026-06-18-merge-queue-stale-tab-refresh-fix)**