Skip to content
Cloudflare Docs

Changelog

New updates and improvements at Cloudflare. Subscribe to RSS

hero image
← Back to all posts

Customize Queue message retention periods

Feb 14, 2025, 12:00 PM
Queues

You can customize a Queue's message retention period, starting from 60s to a maximum of 14 days. Visit the queues docs to learn more.

Customize a Queue's message retention period

By default, Queues retain messages for a default of 4 days. Previously, it was impossible to change the retention period.

With this update, you can retain messages for up to 14 days. Or if you want your consumer to only consume newer messages, you can set the message expiry period to be as short as 60 seconds.

You can customize the retention period on the Queues settings page on the dashboard, or using Wrangler:

Update message retention period
$ wrangler queues update my-queue --message-retention-period-secs 600

This feature is available on all new and existing Queues. If you haven't used Cloudflare Queues before, get started with our guide here.