Changelog for pause & purge

src/content/changelog/queues/2025-03-25-pause-purge-queues.mdx

@@ -0,0 +1,33 @@
+---
+title: Pause & Purge Queues
+description: Manage downtime and invalid messages by pausing delivery, or deleting messages, from a queue.
+products:
+  - queues
+date: 2025-03-27 12:00:00 UTC
+---
+
+You can now pause message delivery from a [queue](/queues/), and purge all messages from a queue. These operations are useful to manage downtime, handle invalid messages, or run migrations.
+
+To pause a queue using [Wrangler](/workers/wrangler/), run the `pause-delivery` command. Paused queues continue to receive messages. And you can easily unpause a queue using the `resume-delivery` command.
+```bash title="Pause and resume a queue"
+$ wrangler queues pause-delivery my-queue
+Pausing message delivery for queue my-queue.
+Paused message delivery for queue my-queue.
+
+$ wrangler queues resume-delivery my-queue
+Resuming message delivery for queue my-queue.
+Resumed message delivery for queue my-queue.
+```
+
+Purging a queue permanently deletes all messages in the queue. Unlike pausing, purging is an irreversible operation:
+```bash title="Purge a queue"
+$ wrangler queues purge my-queue
+✔ This operation will permanently delete all the messages in queue my-queue. Type my-queue to proceed. … my-queue
+Purged queue 'mar-21'
+```
+
+You can also do these operations using our REST API, or the dashboard page for a queue.
+
+![Pause and purge using the dashboard](~/assets/images/queues/pause-purge.png)
+
+This feature is available on all new and existing queues. Head over to the [pause and purge documentation](/queues/configuration/pause-purge) to learn more. And if you haven't used Cloudflare Queues before, [get started with the Cloudflare Queues guide](/queues/get-started).

src/content/release-notes/queues.yaml

@@ -5,6 +5,22 @@ productLink: "/queues/"
 productArea: Developer platform
 productAreaLink: /workers/platform/changelog/platform/
 entries:
+  - publish_date: "2025-03-27"
+    title: Pause delivery and purge queues
+    description: |-
+      Queues includes message management controls to make it easier to handle downtime, or batches of bad messages.
+
+      Message delivery from a Queue to consumers can be paused / resumed. Queues continue to receive messages while paused.
+
+      Queues can be purged, to permanently delete all messages currently stored in a Queue. This operation is useful while testing a new application, if a queue producer was misconfigured and is sending bad messages.
+
+      Refer to the [documentation on Pause & Purge](/queues/configuration/pause-purge/) to learn how to use both operations.
+  - publish_date: "2025-02-14"
+    title: Customize message retention period
+    description: |-
+      You can now customize a queue's message retention period, from a minimum of 60 seconds to a maximum of 14 days. Previously, it was fixed to the default of 4 days.
+
+      Refer to the [Queues confiuguration documentation](/queues/configuration/configure-queues/#queue-configuration) to learn more.
   - publish_date: "2024-09-26"
     title: Queues is GA, with higher throughput & consumer concurrency
     description: |-
@@ -13,7 +29,6 @@ entries:
       The per-queue message throughput has increased from 400 to 5,000 messages per second. This applies to new and existing queues.
 
       Maximum concurrent consumers has increased from 20 to 250. This applies to new and existing queues. Queues with no explicit limit will automatically scale to the new maximum. Review the [consumer concurrency documentation](/queues/configuration/consumer-concurrency) to learn more.
-
   - publish_date: "2024-03-26"
     title: Delay messages published to a queue
     description: |-