Change a queue's settings

Change a queue's visibility timeout, retention, delivery delay, receive wait, maximum message size or content-based deduplication.

Last updated 18 November 2026View as Markdown

Replace my-queue with the name of your queue. The settings are defaults for new messages: a message keeps the retention it was sent with, so a new retention applies to messages sent afterwards. The ranges are in Create a queue. A queue's name and its type (standard or FIFO) cannot be changed.

Prerequisites

  • Permission for queue:SetQueueAttributes on the queue. Without it, the console shows the settings but does not let you change them.
  • For the console, also queue:GetQueueAttributes on the queue, to open its page.

Change the settings

  1. Open the queue, then choose Settings (or, in the ⋯ menu, Edit settings).
  2. Under Delivery, change Visibility timeout (seconds), Retention (seconds), Delivery delay (seconds), Receive wait (seconds) or Maximum message size (bytes).
  3. Choose Save.

Save saves both sections of the page, the dead-letter queue included. Content-based deduplication cannot be changed in the console.

Result

The API answers 200 with the queue's new settings. New receives and sends use them at once.

When a change is refused

  • 400 "ContentBasedDeduplication applies only to FIFO queues." on a standard queue.
  • 404 "There is no queue named “my-queue” here."
Did this page help you?