> ## Documentation Index
> Fetch the complete documentation index at: https://discord-dependabot-npm-and-yarn-actions-core-3-0-1.mintlify.site/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-dependabot-npm-and-yarn-actions-core-3-0-1/0tOOxAmG8wslXAg0/images/social-sdk/design-guidelines/ChatHistory-02.webp?fit=max&auto=format&n=0tOOxAmG8wslXAg0&q=85&s=922775059fd112010905a97932aececd" 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-dependabot-npm-and-yarn-actions-core-3-0-1/0tOOxAmG8wslXAg0/images/social-sdk/design-guidelines/ChatHistory-03.webp?fit=max&auto=format&n=0tOOxAmG8wslXAg0&q=85&s=9499ec6fecb7bff4436b33646d3e855a" 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 |
