Skip to content

Document that ordering is lost for dead-lettered messages#128317

Open
lailabougria wants to merge 1 commit intoMicrosoftDocs:mainfrom
lailabougria:patch-1
Open

Document that ordering is lost for dead-lettered messages#128317
lailabougria wants to merge 1 commit intoMicrosoftDocs:mainfrom
lailabougria:patch-1

Conversation

@lailabougria
Copy link
Copy Markdown

When message processing fails for a message in a session, the message is moved to the dead-letter queue once the MaxDeliveryCount is exceeded. At this point, a receiver can continue consuming messages from that session.
Should the user ever resend the failed message from the dead-letter queue to the original queue, the original ordering is lost.

Added section on MaxDeliveryCount to explain message handling and dead-lettering in sessions.
@prmerger-automator
Copy link
Copy Markdown
Contributor

@lailabougria : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit d382b8c:

✅ Validation status: passed

File Status Preview URL Details
articles/service-bus-messaging/message-sessions.md ✅Succeeded

For more details, please refer to the build report.

@v-dirichards v-dirichards requested a review from Copilot March 19, 2026 15:03
@v-dirichards
Copy link
Copy Markdown
Contributor

@spelluru

Can you review the proposed changes?

Important: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

@prmerger-automator prmerger-automator bot added the aq-pr-triaged tracking label for the PR review team label Mar 19, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds documentation clarifying that session message ordering is not preserved if a dead-lettered message is later resubmitted to the original entity for reprocessing.

Changes:

  • Introduces a new section describing how MaxDeliveryCount affects session processing and dead-lettering.
  • Documents that resubmitting a dead-lettered message back to the queue breaks the original message ordering for the session.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.


## MaxDeliveryCount

When failures occur, and the message is abandoned, it will be made available again on the session for consumption by a receiver until the MaxDeliveryCount is exceeded. When the MaxDeliveryCount is exceeded, the failing message is dead-lettered, and the receiver will continue receiving subsequent messages from the session. If and when the dead-lettered message is moved back to the queue for reprocessing, the original order in which the messages were received is lost.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants