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)
Open the Amazon SQS console at https://console.aws.amazon.com/sqs/
. -
In the navigation pane, choose Queues.
-
Select a queue and choose Edit.
-
Scroll to the Dead-letter queue section and choose Enabled.
-
Choose the Amazon Resource Name (ARN) of an existing Dead Letter Queue that you want to associate with this source queue.
-
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.
-
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.
