Learn how to configure a dead-letter queue using the Amazon SQS console - Amazon Simple Queue Service

Learn how to configure a dead-letter queue using the Amazon SQS console

A dead-letter queue is a queue which source queues can target for messages that are not processed successfully. For more information, see Using dead-letter queues in Amazon SQS .

Amazon SQS does not create the dead-letter queue automatically. You must first create the queue before using it as a dead-letter queue. For instructions on creating a queue to use as a dead letter queue, see Create a queue using the Amazon SQS console.

The dead-letter queue of a FIFO queue must also be a FIFO queue. Similarly, the dead-letter queue of a standard queue must also be a standard queue.

When you create or edit a queue, you can configure a dead-letter queue.

To configure a dead-letter queue for an existing queue (console)
  1. Open the Amazon SQS console at https://console.aws.amazon.com/sqs/.

  2. In the navigation pane, choose Queues.

  3. Select a queue and choose Edit.

  4. Scroll to the Dead-letter queue section and choose Enabled.

  5. Choose the Amazon Resource Name (ARN) of an existing Dead Letter Queue that you want to associate with this source queue.

  6. To configure the number of times that a message can be received before being sent to a dead-letter queue, set Maximum receives to a value between 1 and 1,000.

  7. When you finish configuring the dead-letter queue, choose Save.

    After you save the queue, the console displays the Details page for your queue. On the Details page, the Dead-letter queue tab displays the Maximum Receives and Dead Letter Queue ARN in the Dead-letter queue.