Delivery receipts

Show users when their messages have been delivered.

View as Markdown

Delivery receipts are visual indicators that a message has reached the TalkJS server and is on its way to other participants.

A single checkmark below a user message indicates that the message has reached the TalkJS servers

A delivery receipt, indicated by a single checkmark

How delivery receipts work

In the process of sending, a message can have various statuses including the following:

StatusDescription
SendingThe system is sending the message to the server. Shown as a loading spinner by default.
SentThe server has received the message. Shown as a single checkmark by default.

The chat UI updates the indicator of the message status in real-time as the message moves through each state. Once all participants have read the message, the indicator updates further, see: Read receipts.

In themes

Delivery receipts are available by default on all chat UI themes.

Components SDKs

In the Components SDKs, delivery receipts are rendered with messageStatus, which is available on the <Message> theme component. You can edit the <Message> theme component just like you would make any other update to your chat UI theme. This way, you have full control over how or whether you render the delivery receipt indicator based on the message's status.

See the theme customization docs:

React Native, Flutter, and Classic SDKs

Delivery receipts are available as <StatusTicks>, which renders ticks to indicate the message's status. <StatusTicks> is a subcomponent of the <UserMessage> component, which is rendered for each message sent by a user.

You can customize the <StatusTicks> subcomponent directly from the Themes page on your TalkJS dashboard.

See also