update queues default message retention value by jkoe-cf · Pull Request #12458 · cloudflare/workers-sdk

jkoe-cf · 2026-02-06T23:20:21Z

Fixes #12438
Fixes #12442
Fixes #12460
Fixes MQ-1094

Removing the wrangler default for queues message retention because it is already set to the default value if no value is passed into the API call. Also updating copy around free tier users having a different max retention setting value than paid (message retention must be between 60 and 86400 seconds if on free tier, otherwise must be between 60 and 1209600 seconds).

Otherwise, current workaround is to pass in an explicit message-retention-period-secs value like:

wrangle queues create <queue name> --message-retention-period-secs=100

Also removing the wrangler default for delivery delay because it is also already set to the default value if no value is passed into the API call.

Internal discussion

Tests
- Tests included/updated
- Automated tests not possible - manual testing has been completed as follows:
- Additional testing not necessary because: tests should pass again after this change
Public documentation
- Cloudflare docs PR(s):
- Documentation not necessary because: Tracked in MQ-1090

A picture of a cute animal (not mandatory, but encouraged)

changeset-bot · 2026-02-06T23:20:26Z

🦋 Changeset detected

Latest commit: 5c52f4a

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

devin-ai-integration

Devin Review found 1 potential issue.

View 3 additional findings in Devin Review.

packages/wrangler/src/queues/constants.ts

devin-ai-integration

Devin Review found 1 new potential issue.

View 5 additional findings in Devin Review.

packages/wrangler/src/queues/cli/commands/create.ts

pkg-pr-new · 2026-02-06T23:36:01Z

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@12458

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@12458

miniflare

npm i https://pkg.pr.new/miniflare@12458

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@12458

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@12458

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@12458

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@12458

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@12458

@cloudflare/workers-utils

npm i https://pkg.pr.new/@cloudflare/workers-utils@12458

wrangler

npm i https://pkg.pr.new/wrangler@12458

commit: 8364b1e

packages/wrangler/src/__tests__/queues/queues.test.ts

packages/wrangler/src/queues/constants.ts

devin-ai-integration

Devin Review found 1 new potential issue.

View 4 additional findings in Devin Review.

packages/wrangler/src/queues/cli/commands/create.ts

petebacondarwin · 2026-02-07T12:10:47Z

We need a changeset for this fix. Adding one for you.

…QBW/EWC settinga

petebacondarwin

This is a great change to the PR. I assume that there are two defaults internally?
I was worried that it would be a breaking change to change the default.
(We should probably change the PR title, etc).

jkoe-cf · 2026-02-08T18:49:04Z

This is a great change to the PR. I assume that there are two defaults internally? I was worried that it would be a breaking change to change the default. (We should probably change the PR title, etc).

Yep, free tier and paid users have a different max retention setting value which is handled internally (the default is the same internally as in wrangler, so wrangler doesn't need to send the default).

vicb · 2026-02-08T20:10:10Z

.changeset/twenty-bushes-enter.md

+"wrangler": minor
+---
+
+removing default values for message retention to reflect different limits for free tier queues


Could you please maybe add the free and paid limits to the changeset as a reminder?

vicb

LGTM with one nit for the changeset.

Thanks!

.changeset/twenty-bushes-enter.md

sdnts · 2026-02-09T20:04:11Z

packages/wrangler/src/__tests__/queues/queues.test.ts

@@ -196,9 +196,6 @@ describe("wrangler", () => {
 				if (queueSettings?.delivery_delay === undefined) {
 					queueSettings.delivery_delay = 0;
 				}


Can we make the same change for the delivery delay as well? (Maybe in a separate PR though)

Maybe #12279 is related to that?
@penalosa ?

Updated the PR, description, and changeset to take out the delivery default as well

packages/wrangler/src/__tests__/queues/queues.test.ts

…ree tier users

…-value

packages/wrangler/src/__tests__/queues/queues.test.ts

Co-authored-by: Victor Berchet <[email protected]>

petebacondarwin

I made a bunch of suggestions to how we can lay out the changeset a bit differently. But otherwise LGTM.

.changeset/twenty-bushes-enter.md

Co-authored-by: Pete Bacon Darwin <[email protected]>

…-value

Updating default queues message retention after introducing free tier

d1354db

jkoe-cf requested a review from a team as a code owner February 6, 2026 23:20

workers-devprod added this to workers-sdk Feb 6, 2026

github-project-automation bot moved this to Untriaged in workers-sdk Feb 6, 2026

devin-ai-integration bot reviewed Feb 6, 2026

View reviewed changes

packages/wrangler/src/queues/constants.ts Outdated Show resolved Hide resolved

jkoe-cf force-pushed the jkoe/update-queues-default-message-retention-value branch from 4039b7e to 6cb017d Compare February 6, 2026 23:24

devin-ai-integration bot reviewed Feb 6, 2026

View reviewed changes

packages/wrangler/src/queues/cli/commands/create.ts Show resolved Hide resolved

jkoe-cf force-pushed the jkoe/update-queues-default-message-retention-value branch from 6cb017d to 38c5276 Compare February 6, 2026 23:29

sdnts reviewed Feb 6, 2026

View reviewed changes

packages/wrangler/src/__tests__/queues/queues.test.ts Show resolved Hide resolved

packages/wrangler/src/queues/constants.ts Outdated Show resolved Hide resolved

packages/wrangler/src/queues/constants.ts Show resolved Hide resolved

Updating default value text and test values

7cc6994

jkoe-cf force-pushed the jkoe/update-queues-default-message-retention-value branch from 38c5276 to 7cc6994 Compare February 6, 2026 23:43

devin-ai-integration bot reviewed Feb 6, 2026

View reviewed changes

packages/wrangler/src/queues/cli/commands/create.ts Show resolved Hide resolved

Fixing typo on queues delivery delay text

7b2dfea

petebacondarwin approved these changes Feb 7, 2026

View reviewed changes

github-project-automation bot moved this from Untriaged to Approved in workers-sdk Feb 7, 2026

petebacondarwin approved these changes Feb 7, 2026

View reviewed changes

Removing default value from wrangler so that the setting defaults to …

6bd1a5e

…QBW/EWC settinga

jkoe-cf force-pushed the jkoe/update-queues-default-message-retention-value branch from f8ff03d to 6bd1a5e Compare February 8, 2026 18:20

petebacondarwin approved these changes Feb 8, 2026

View reviewed changes

vicb reviewed Feb 8, 2026

View reviewed changes

vicb approved these changes Feb 8, 2026

View reviewed changes

Updating changeset description with queues message retention limits

a14f498

vicb reviewed Feb 9, 2026

View reviewed changes

.changeset/twenty-bushes-enter.md Outdated Show resolved Hide resolved

Updating changeset description

3fd0606

sdnts reviewed Feb 9, 2026

View reviewed changes

packages/wrangler/src/__tests__/queues/queues.test.ts Show resolved Hide resolved

jkoe-cf and others added 3 commits February 9, 2026 13:36

Removing delivery delay default

69a5489

Updating changeset with more details of default value as related to f…

97f5f3c

…ree tier users

Merge branch 'main' into jkoe/update-queues-default-message-retention…

99b0261

…-value

vicb reviewed Feb 9, 2026

View reviewed changes

packages/wrangler/src/__tests__/queues/queues.test.ts Outdated Show resolved Hide resolved

Update packages/wrangler/src/__tests__/queues/queues.test.ts

c628ab3

Co-authored-by: Victor Berchet <[email protected]>

petebacondarwin approved these changes Feb 10, 2026

View reviewed changes

.changeset/twenty-bushes-enter.md Outdated Show resolved Hide resolved

.changeset/twenty-bushes-enter.md Outdated Show resolved Hide resolved

.changeset/twenty-bushes-enter.md Outdated Show resolved Hide resolved

jkoe-cf and others added 4 commits February 10, 2026 09:16

Update changeset

7521764

Co-authored-by: Pete Bacon Darwin <[email protected]>

Update changeset

822e134

Co-authored-by: Pete Bacon Darwin <[email protected]>

Update changeset

5c52f4a

Co-authored-by: Pete Bacon Darwin <[email protected]>

Merge branch 'main' into jkoe/update-queues-default-message-retention…

8364b1e

…-value

petebacondarwin merged commit 122791d into cloudflare:main Feb 10, 2026
37 of 38 checks passed

github-project-automation bot moved this from Approved to Done in workers-sdk Feb 10, 2026

workers-devprod mentioned this pull request Feb 10, 2026

Version Packages #12508

Merged

Conversation

jkoe-cf commented Feb 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot bot commented Feb 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

devin-ai-integration bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

devin-ai-integration bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

pkg-pr-new bot commented Feb 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

devin-ai-integration bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

petebacondarwin commented Feb 7, 2026

Uh oh!

petebacondarwin left a comment

Choose a reason for hiding this comment

Uh oh!

jkoe-cf commented Feb 8, 2026

Uh oh!

vicb Feb 8, 2026

Choose a reason for hiding this comment

Uh oh!

vicb left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

sdnts Feb 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

vicb Feb 9, 2026

Choose a reason for hiding this comment

Uh oh!

jkoe-cf Feb 9, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

petebacondarwin left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

jkoe-cf commented Feb 6, 2026 •

edited

Loading

changeset-bot bot commented Feb 6, 2026 •

edited

Loading

pkg-pr-new bot commented Feb 6, 2026 •

edited

Loading

sdnts Feb 9, 2026 •

edited

Loading