Delivery and store-and-forward

What is a delivery receipt?

A delivery receipt is a notice sent back to the sender confirming that a message reached its destination, such as the recipient's mailbox or messaging client. It confirms delivery only. It does not show that anyone read the message or acted on it, which is why standards define read receipts separately and why applications often add their own acceptance receipt on top.

TL;DR

A receipt proves only that a message reached one point: a mail server, chat client and receiving application each confirm something different. Read receipts are separate and optional; a missing receipt is a weak reason to resend unless repeats are handled idempotently. For important work, the receiving app should send its own receipt after validating and storing the message.

Learning objectives

After reading this article you will be able to:

  • Explain what email DSNs and XMPP delivery receipts confirm, and what they do not
  • Distinguish delivery receipts from read receipts and displayed markers
  • Explain why a missing receipt is a weak reason to resend a message

Delivery receipt meaning

Every receipt confirms one narrow fact: that the message got to a particular point. The point matters. A receipt from a mail server, from a chat client, and from the application that has to act on the message confirm three different things, even if all three are shown to the user as “delivered”.

Standards are careful about this. In email, RFC 3461 says delivery means the message has been placed in the recipient’s mailbox. For mail collected later over IMAP or POP, delivery happens when the message is made available to that service, not when the recipient’s mail program fetches it. In XMPP, XEP-0184 says its receipts confirm that a message was delivered to a client, not that it was read or understood by a person.

A delivery receipt is a kind of acknowledgment that travels back to the original sender, often across several hops, rather than one exchanged between two neighbouring links.

Email delivery status and read receipts

Email splits receipts into two standards: Delivery Status Notifications (RFC 3461) for delivery, and Message Disposition Notifications (RFC 8098) for what happens after it, such as the message being displayed.

Delivery Status Notifications (DSNs). RFC 3461 lets the sender attach a NOTIFY parameter to each recipient. SUCCESS asks for a notice on successful delivery and FAILURE on failure. DELAY says the sender is willing to receive a notice when delivery has been delayed for an unusual time but the final outcome is not yet known. NEVER asks for no notice at all. When a message passes into a system that cannot confirm delivery, such as a mail system beyond a gateway, the server should send a “relayed” DSN instead: the sender learns the message was passed on, not that it arrived.

Message Disposition Notifications (MDNs). RFC 8098 covers what happens after delivery, such as the message being displayed, or deleted without being displayed. These are what most people call read receipts. A sender requests one with a Disposition-Notification-To header, but that is only a request: the recipient’s mail program is always free to ignore it. RFC 8098 strongly recommends asking the user’s consent before sending one and says the default should be not to send them.

XMPP delivery receipts and displayed markers

XMPP follows the same split: XEP-0184 receipts confirm delivery to a client, and XEP-0333 markers say which messages a client has displayed.

  • XEP-0184, Message Delivery Receipts. The sender marks a message as wanting a receipt, and the recipient’s client returns an ack message saying it was received. The specification is blunt about its limits: it does not provide complete or even partial reliability, and it does not tell the sender whether the message was read, understood or processed.
  • XEP-0333, Displayed Markers. A client tells the sender, or the other members of a group chat, that it has displayed messages up to a certain point. One marker covers every earlier message, so a client that shows several messages at once sends a marker only for the latest. Earlier drafts also had received and acknowledged markers. They were removed, because most implementers preferred XEP-0184’s per-message receipts and the acknowledged marker had gone unimplemented.

Missing delivery receipts

A missing delivery receipt does not necessarily mean the message was lost. Receipts are easy to over-read in both directions. XEP-0184 lists reasons a sender might never get one even though the message arrived: the recipient’s client may not support receipts, the server may have delivered the message to another of the user’s clients that does not support receipts, or the recipient may simply choose not to send one. It concludes that the sender should not read meaning into a missing receipt unless the recipient has agreed to honour requests, and it recommends against resending on that basis alone.

Resending is risky anyway, because the receiver may then process the message twice. A system that retries on a missing receipt needs idempotent handling at the receiver, so a repeated message does not repeat the work.

Delivered vs accepted messages

A delivered message is not the same as an accepted one. For work that matters, such as a handover between two crews, “the device received it” is not enough. The receiving application might reject the request, crash before storing it, or need a person to approve it. So applications often define their own receipt, sent by the receiving app only after it has validated and stored the message.

Offline Protocol’s local handoff guide is one documented example. In its mesh SDK, a message_delivered event settles a send, but the guide notes that at that point the receiver may not yet have stored the record. The receiving app commits the operation locally and then sends an application receipt back over the encrypted messaging path. Delivery, local acceptance and backend commit are tracked as separate states, each with its own evidence. Delivered, accepted, committed explains why the three differ.

Delivery and read receipt privacy

Receipts reveal information about the recipient. RFC 8098 notes that sending MDNs can disclose when a message was read and which mail program and operating system were used, and that it is acceptable for a mail program to silently ignore requests. XEP-0333 says clients should let people opt out of sharing displayed markers. Delivery receipts reveal something too: when the recipient’s client was reachable.

Frequently asked questions

What is the difference between a delivery receipt and a read receipt?

A delivery receipt says the message reached the recipient's mailbox or client. A read receipt says it was displayed. Email defines them in separate standards, RFC 3461 for delivery status and RFC 8098 for disposition, and XMPP does the same with XEP-0184 and XEP-0333.

If I get no receipt, was the message lost?

Not necessarily. The recipient's software may not support receipts, may be configured not to send them, or the receipt itself may be delayed or lost. XEP-0184 tells senders not to read meaning into a missing receipt unless the recipient has agreed to send them.

What does the NOTIFY parameter do in email?

RFC 3461 lets the sender attach a NOTIFY parameter to each recipient. SUCCESS asks for a notice on successful delivery, FAILURE on failure, DELAY when delivery has been delayed for an unusual time, and NEVER asks for no notice at all.

What is a relayed delivery status notification?

When a message passes into a system that cannot confirm delivery, such as a mail system beyond a gateway, the server should send a relayed DSN instead of a delivery notice. The sender learns the message was passed on, not that it arrived.

Can a recipient refuse to send read receipts?

Yes. The recipient's mail program is always free to ignore a read receipt request, and RFC 8098 says the default should be not to send them. In chat, XEP-0333 says clients should let people opt out of sharing displayed markers.

Do XMPP delivery receipts make messaging reliable?

No. XEP-0184 says its receipts do not provide complete or even partial reliability, and they do not tell the sender whether the message was read, understood or processed.

Sources

Build it with Offline Protocol

The local handoff guide shows how to track pending, delivered, accepted and committed as separate states, and how the receiving app sends its own receipt only after it has stored the record.

Read the local handoff guide