Cloudflare Docs
Edit this page
Report an issue with this page
Log into the Cloudflare dashboard
Set theme to dark (⇧+D)

List and acknowledge messages from the dashboard

​​ List messages from the dashboard

Listing messages from the dashboard allows you to debug Queues or queue producers without a consumer Worker. Fetching a batch of messages to preview will not acknowledge or retry the message or affect its position in the queue. The queue can still be consumed normally by a consumer Worker.

To list messages in the dashboard:

  1. Log in to the Cloudflare dashboard and select your account.
  2. Select Workers & Pages > Queues.
  3. Select the queue to preview messages from.
  4. Select the Messages tab.
  5. Select Queued Messages.
  6. Select a maximum batch size of messages to fetch. The size can be a number from 1 to 100. If a consumer Worker is configured, this defaults to your consumer Worker’s maximum batch size.

A form to configure how many messages are listed at a time, with a number input showing ‘10’

  1. Select List messages.
  2. When the list of messages loads, select the blue arrow to the right of each row to expand the message preview.

A table showing two previewed messages, one text and one JSON, both with some placeholder text

This will preview a batch of messages currently in the Queue.

​​ Acknowledge messages from the dashboard

Acknowledging messages from the Cloudflare dashboard will permanently remove them from the queue, with equivalent behavior as ack() in a Worker.

  1. Select the checkbox to the left of each row to select the message for acknowledgement, or select the checkbox in the table header to select all messages.
  2. Select Acknowledge messages.
  3. Confirm you want to acknowledge the messages, and select Acknowledge messages.

This will remove the selected messages from the queue and prevent consumers from processing them further.

Refer to the Get Started guide to learn how to process and acknowledge messages from a queue in a Worker.