Overview of Rich Presence

Learn how to integrate Rich Presence to display activity information on user profiles.

Rich Presence lets you display actionable data in a Discord user’s profile about what they’re up to in your game or app. The data you choose to display is up to you—whether it’s a user’s score, the duration they’ve been playing your game, what they’re listening to on your platform, or something else.

---

Choosing an SDK

There are three options when integrating Rich Presence. Depending on what you’re building, you’ll want to choose the right SDK for your project:

• The Discord Social SDK allows you to build social features into your game or app, including friends lists, game invites, and more.
• The Embedded App SDK should be used if you’re building an Activity in Discord.
• The Game SDK (legacy) can be used if you’re building an off-platform game or app and you want to integrate it into Discord.

All SDKs use similar underlying primitives (like the SET_ACTIVITY RPC command), so a lot is the same between them. But there are a few differences, like feature compatibility, which is covered in the sections below.

Rich Presence data appears publicly on your Discord profile, so during development you should use a test account that only belongs to your private development server(s).

Discord Social SDK

The Discord Social SDK is used for building social features directly into your game. When a user is playing your game, you can show what they’re up to in their Discord profile and even prompt their friends to join in with game invites.

When integrating Rich Presence with an off-platform game, data can be shown about what a user is up to in your game. A “Join” button can also be configured to allow a user’s friends to jump into their game and enable sending game invites.

Read about using Rich Presence with the Discord Social SDK

Embedded App SDK

The Embedded App SDK is used to build Activities, which are multiplayer games and social experiences hosted in an iframe within Discord. The SDK handles communication between Discord and the Activity and helps integrate platform features (like Rich Presence!).

After a user joins an Activity, Rich Presence can be used to dynamically show data about what that user is doing or playing, as well as prompt others to join in and play along.

Read about using Rich Presence with the Embedded App SDK

Game SDK

The Game SDK has been archived.

We recommend using the Discord Social SDK for new projects.

Existing projects using the Game SDK will continue to work, but we encourage you to migrate to the Discord Social SDK for new features and updates.

The Game SDK makes it easier to build 3rd party games and integrate them with Discord. While many features of the Game SDK are deprecated, it can still be used for a few use cases (like integrating Rich Presence!).

When integrating Rich Presence with an off-platform game, data can be shown about what a user is up to in your game. A “Join” button can also be configured to allow a user’s friends to jump into their game.

Read about using Rich Presence with the Game SDK

Adding Custom Art Assets

While integrating Rich Presence, you’ll likely want to upload custom art assets for your app. For all Rich Presence assets, it’s highly recommended to make them 1024 x 1024.

To add custom assets for Rich Presence, navigate to your app’s settings and click Rich Presence on the left-hand sidebar. On the Art Assets page, there are two different types of assets you can upload.

Invite Image

The Rich Presence invite image appears when invites are sent for a 3rd party game or app using the Game SDK. After uploading an invite image for your app, you can see a preview of it to the right (under “IRL Invite Image Example”).

The invite image can be ignored if you’re building using the Embedded App SDK. Invites sent using the Embedded App SDK’sopenInviteDialog() use the Activity’s cover art.

Assets

Up to 300 custom assets can be added for your app to use when setting Rich Presence for a Discord user. These assets can be anything that help orient others to what a user is doing inside of your Activity or 3rd party game.

If you need more than 300 custom assets or want to use images stored somewhere else, you can also specify an external URL as long it still has the proper dimensions and size.

For tips on choosing assets, take a look at the Rich Presence best practices guide.

When uploading Rich Presence assets, the asset keys will automatically be changed to lowercase. You can see this reflected in your app’s settings after saving a newly-uploaded asset, and should keep it in mind when referencing any asset keys in your code.

Using the Visualizer

The Rich Presence visualizer currently uses an outdated Discord UI, but can still be helpful as a quick-and-dirty reference for what your Rich Presence data will look like in Discord.

In your app’s settings, there’s a Rich Presence visualizer to make it easier to see what your uploaded assets will look like in the context of a Discord profile. To access the visualizer, navigate to your app’s settings and click Rich Presence on the left-hand sidebar. On the Visualizer page, you can fill out some custom strings, party information, and select your uploaded assets to see a preview.

Start Building

Using Rich Presence with the Embedded App SDK

Guide on using Rich Presence in the Embedded App SDK while you’re building an Activity

Using Rich Presence with the Game SDK

Guide on using Rich Presence in the Game SDK

Designing your Data for Rich Presence

Best practices and launch checklist for when you’re integrating Rich Presence with your game or app