Rich Presence is a new feature from Discord that allows you to surface unique, interesting, and actionable data inside a Discord user’s profile when they play your game! This guide is intended to show some best practices on how to make that data the best it can be. It will include images and code samples; for full technical documentation, see our developer documentation.If you take away one thing from this guide, let it be this:
Rich Presence is a powerful way to integrate your game with Discord. To do it most effectively, you should think about its purpose and how well (or not) it matches with your game and your implementation. Rich Presence is designed for these three things:
Rich Presence data should give others a clear understanding of what someone is doing so they can decide if they want to play together or not.
- Show interesting, unique, actionable data in a user’s profile
- Allow friends to spectate each other’s games
- Join a friend’s in-game party or server directly from Discord
- What the player is currently doing
- How much time has elapsed or remains (if applicable)
- Their party state
- Your cool artwork!
stateshould be snippets of data, not sentences.
- Make sure your strings stay on one line—especially on the small profile!
|The data wraps onto multiple lines. It’s repetitive, slower to read, and messy.||The data all fits on one line per string. Clean!|
- Always keep party size data up to date.
- Keep accurate track of party state: In Queue, In Game, In Menus, etc.
- Include game modes, ranked vs. unranked, etc. so others can clearly see.
|While Rank 9999 is impressive, it doesn’t present any actionable data for their friends.||This player is in queue for something I want to play. Let's ask to join that open spot!|
- Make use of all the fields that are applicable to you.
- Save space by putting map and character names in the tooltips.
- Try not to repeat information.
|The map name takes up space and makes the player's status harder to read at a glance.||Moving the name of the map to the tooltip makes the data cleaner and frees up space for the score.|
- The large image should be consistent for all players in a party.
- The small image is where you can customize on a per-player basis.
- Use high resolution artwork so your art looks great on fancy, high DPI screens.
- We strongly recommend image sizes of 1024x1024 pixels.
|The image is dark and unfocused. Highly-detailed images can be hard to see.||This image is bright and matches the details. Let's help!|