Skip to content

docs(merge-queue): changelog for Stale PR Timeout setting #279

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
samgutentag wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(merge-queue): changelog for Stale PR Timeout setting #279

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions changelog/2026-06-25-merge-queue-stale-pr-timeout.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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.
6 changes: 6 additions & 0 deletions changelog/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,12 @@ rss: true
The Trunk browser extension 0.13.0 ships performance improvements and bug fixes.
</Update>

<Update label="June 25, 2026" tags={["Merge Queue"]}>
**[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.
</Update>

<Update label="June 18, 2026" tags={["Merge Queue"]}>
**[Merge Queue: Queue and Graph Tabs Now Refresh on Return](/changelog/2026-06-18-merge-queue-stale-tab-refresh-fix)**

Expand Down
1 change: 1 addition & 0 deletions docs.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
14 changes: 14 additions & 0 deletions merge-queue/administration/advanced-settings.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.

<Info>
Organization admin access is required to change this setting.
</Info>

***

## Required Status Checks

> Configure which CI status checks must pass before a PR can merge through the queue.
Expand Down
6 changes: 6 additions & 0 deletions merge-queue/changelog.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,12 @@ og:title: "Trunk Merge Queue changelog"
The Trunk browser extension 0.13.0 ships performance improvements and bug fixes.
</Update>

<Update label="June 25, 2026" tags={["Merge Queue"]}>
**[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.
</Update>

<Update label="June 18, 2026" tags={["Merge Queue"]}>
**[Merge Queue: Queue and Graph Tabs Now Refresh on Return](/changelog/2026-06-18-merge-queue-stale-tab-refresh-fix)**

Expand Down
Loading