Message storage and history

The history feature enables users to retrieve messages that have been previously sent in a room. Ably stores chat messages for 24 hours by default. You can extend this up to 30 days by contacting us.

JavaScriptReact
Select...

const historicalMessages = await room.messages.get({ direction: 'backwards', limit: 50 });
console.log(historicalMessages.items);


if (historicalMessages.hasNext()) {
  const next = await historicalMessages.next();
  console.log(next);
} else {
  console.log('End of messages');
}

Copy
Copied!

The following optional parameters can be passed when retrieving previously sent messages:

Users can also retrieve historical messages that were sent to a room before the point that they registered a listener by subscribing. The order of messages returned is from most recent, to oldest. This is useful for providing conversational context when a user first joins a room, or when they subsequently rejoin it later on. It also ensures that the message history they see is continuous, without any overlap of messages being returned between their subscription and their history call.

JavaScriptReact
Select...

const { getPreviousMessages } = room.messages.subscribe(() => {
  console.log('New message received');
});


const historicalMessages = await getPreviousMessages({ limit: 50 });
console.log(historicalMessages.items);
if (historicalMessages.hasNext()) {
  const next = await historicalMessages.next();
  console.log(next);
} else {
  console.log('End of messages');
}

Copy
Copied!

The following parameters can be passed when retrieving previously sent messages: