> ## Documentation Index
> Fetch the complete documentation index at: https://docs.discord.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Chat History Design Guidelines

> Design guidelines for displaying and managing chat history from Discord.

## Style recommendations

Chat history is a highly requested **optional** feature that helps players pick up conversations where they left off—whether they're returning to a lobby or jumping back into a linked channel.

We recommend showing **timestamps** to give players better context about when messages were sent and seen.

<img src="https://mintcdn.com/discord/DCDjFHiqz1h7oI8V/images/social-sdk/design-guidelines/ChatHistory-02.webp?fit=max&auto=format&n=DCDjFHiqz1h7oI8V&q=85&s=3e19d8fd6fce859efd861285e87c8a63" alt="Badge when online elsewhere" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/ChatHistory-02.webp" />

## Display logic

If one player is messaging from a game lobby or linked channel, then chat history is preserved, even if the other player is messaging from Discord.

When players return to a lobby or open a linked channel, we recommend surfacing **10 to 15** of the most recent messages to provide meaningful context. This isn't a hard limit—older messages can be revealed through scroll or loading more content, depending on your UI constraints.

<img src="https://mintcdn.com/discord/DCDjFHiqz1h7oI8V/images/social-sdk/design-guidelines/ChatHistory-03.webp?fit=max&auto=format&n=DCDjFHiqz1h7oI8V&q=85&s=2e36aedf618348bfd4cdee0e62df17ed" alt="Message styling" width="3840" height="2160" data-path="images/social-sdk/design-guidelines/ChatHistory-03.webp" />

***

## Resources

* [Development Guide: Creating and Managing Lobbies](/developers/discord-social-sdk/development-guides/managing-lobbies)

## Change Log

| Date          | Changes         |
| ------------- | --------------- |
| July 02, 2025 | initial release |
