Getting Started with Unity and the Discord Social SDK - Documentation

Overview

This guide will walk you through integrating the Discord Social SDK into a Unity project. By the end, you’ll have a project that can:

Authenticate users with Discord
Set up logging and status monitoring
Start the SDK and establish a connection
Request the number of Discord friends the player has
Set the player’s rich presence for your game

Prerequisites

Before starting, ensure you have:

Unity 2021.3 or later

Let’s walk through the steps in detail.

Step 1: Create a Discord Developer Team

Before you start, you’ll need to create a developer team on the Discord Developer Portal. This team will be used to manage your Discord applications and SDK integrations. If you already have a team configured, you can skip this step.

Create a developer team on the Discord Developer Portal.

Later, you can invite your team members to your new team to collaborate on your integration.

Step 2: Create a Discord Application

Create a new application on the Discord Developer Portal and assign it to your team.
Add a redirect URL in the OAuth2 tab:
- For desktop applications: http://127.0.0.1/callback (this can be changed later).
- See discordpp::Client::Authorize for more details on setting up more advanced redirect URIs.
Enable the Public Client toggle in the OAuth2 tab.

This guide requires enabling Public Client to allow you to get started with the SDK quickly. Most games will not want to ship as a public client. This setting should be reviewed by your team prior to releasing your game. Learn more about public clients.

Once you’ve created your Discord application, you’ll need to enable the Discord Social SDK for it.

From the Discord Developer Portal, select your newly created application from Step 2.
In the left sidebar for your app, locate and click the Getting Started link under Discord Social SDK.
Fill out the form to share details about your game.
Click Submit and the Social SDK will be enabled for your application.
Once enabled, you’ll find binaries for the Social SDK under Downloads.

Click on the Downloads link under the Discord Social SDK section of the sidebar.
Select the latest version from the version dropdown and download the SDK for Unity.

A Unity sample project is available for download on this page, but we are not going to cover it in this guide. Explore it on your own after you finish this guide!

Step 5: Project Setup

Let’s set up your Unity project to include the Social SDK package and add the necessary objects and scripts to use it.

Create a new 2D project in Unity Hub using Unity version 2021.3 or later
Either:
1. Unzip the zip file in the Unity Packages folder, or
2. Unzip the zip file and Install Package from Disk. Make sure the folder is in a directory that won’t get moved or deleted as your Unity project will load it from that location.
In your project add a Scripts folder and create a DiscordManager.cs script
Add the following code to DiscordManager.cs:

using UnityEngine;
using UnityEngine.UI;
using Discord.Sdk;
using System.Linq;

public class DiscordManager : MonoBehaviour
{
    [SerializeField] 
    private ulong clientId; // Set this in the Unity Inspector from the dev portal
    
    [SerializeField]
    private Button loginButton; 
    
    [SerializeField] 
    private Text statusText;

    private Client client;
    private string codeVerifier;
}

Add an empty object to the scene (GameObject > Create Empty) called DiscordManager and attach the DiscordManager.cs script to it
Add a button to the scene GameObject > UI > Legacy > Button
Add text to the scene GameObject > UI > Legacy > Text
Position the button and text somewhere visible on the screen
Attach the button and text to the DiscordManager in the inspector
Run it!

This is all we’ll need to get started! You shouldn’t see anything happen, but if you run into any issues, check out the troubleshooting section before moving to the next step.

Troubleshooting

Make sure the Social SDK package was successfully added to Unity

Mac libdiscord_partner_sdk.dylib Not Opened

On Mac you may get the error “libdiscord_partner_sdk.dylib” Not Opened because Apple couldn’t verify it. If this happens press Done on the popup.

You’ll need to open your System Settings > Privacy & Security and scroll down to the Security section. It will tell you “libdiscord_partner_sdk.dylib” was blocked to protect your Mac. Press Open Anyway and try running again.

Now when you get the pop up you’ll have the option to select Open Anyway and it will be able to use it successfully.

Step 6: Setting Up SDK Event Handling

Let’s add some event handlers to monitor what’s happening with our Discord connection. We’ll set up two important callbacks:

A logging callback to see what the SDK is doing
A status callback to know when we can start using Discord features

We’ll start by adding the following code to your DiscordManager.cs:

void Start()
{
    client = new Client();

    // Modifying LoggingSeverity will show you more or less logging information
    client.AddLogCallback(OnLog, LoggingSeverity.Error);
    client.SetStatusChangedCallback(OnStatusChanged);

    // Make sure the button has a listener
    if (loginButton != null)
    {
        //loginButton.onClick.AddListener(StartOAuthFlow);
    }
    else
    {
        Debug.LogError("Login button reference is missing, connect it in the inspector!");
    }

    // Set initial status text
    if (statusText != null)
    {
        statusText.text = "Ready to login";
    }
    else
    {
        Debug.LogError("Status text reference is missing, connect it in the inspector!");
    }
}

private void OnLog(string message, LoggingSeverity severity)
{
    Debug.Log($"Log: {severity} - {message}");
}

private void OnStatusChanged(Client.Status status, Client.Error error, int errorCode)
{
    Debug.Log($"Status changed: {status}");
    statusText.text = status.ToString();
    if(error != Client.Error.None)
    {
        Debug.LogError($"Error: {error}, code: {errorCode}");
    }
}

This will hook up the API status changes to your text in the game. Then we’ll need to get your Client ID from the OAuth2 tab in the developer portal and paste it into the ClientID on the DiscordManager in the inspector.

What These Callbacks Do

The logging callback shows you what’s happening behind the scenes and is a powerful tool for debugging
The status callback tells you when you’re connected and ready to use Discord features

The Unity plugin handles running the SDK callbacks for you in Unity, no need to use RunCallbacks like we do in the C++ guide.

Most Discord features won’t work until the status is Ready. The status callback lets you know when you can start using them.

To get to a Ready state, we need to authenticate with Discord. Let’s do that next.

Step 7: Account Linking with Discord

In this step, we’ll implement OAuth2 authentication to support account linking with Discord. This process will:

Open the Discord app or a browser window for Discord login
Get an authorization code
Exchange it for an access token
Connect to Discord

Add the Authentication Code

To start we’ll add this code to your DiscordManager.cs:

private void StartOAuthFlow() {
    var authorizationVerifier = client.CreateAuthorizationCodeVerifier();
    codeVerifier = authorizationVerifier.Verifier();
    
    var args = new AuthorizationArgs();
    args.SetClientId(clientId);
    args.SetScopes(Client.GetDefaultPresenceScopes());
    args.SetCodeChallenge(authorizationVerifier.Challenge());
    client.Authorize(args, OnAuthorizeResult);
}

private void OnAuthorizeResult(ClientResult result, string code, string redirectUri) {
    Debug.Log($"Authorization result: [{result.Error()}] [{code}] [{redirectUri}]");
    if (!result.Successful()) {
        return;
    }
    GetTokenFromCode(code, redirectUri);
}

private void GetTokenFromCode(string code, string redirectUri) {
    client.GetToken(clientId,
                    code,
                    codeVerifier,
                    redirectUri,
                    (result, token, refreshToken, tokenType, expiresIn, scope) => {});
}

and then we’ll uncomment loginButton.onClick.AddListener(StartOAuthFlow); in your Start() method

if (loginButton != null)
{
    loginButton.onClick.AddListener(StartOAuthFlow);
}

What’s Happening Here?

We create a code verifier for OAuth2 PKCE security
Set up authorization arguments with your app ID and required scopes
Start the auth flow with Client::Authorize, which opens a browser
When authorized, we exchange the code for an access token

Never log or store access tokens insecurely! They should be treated as sensitive credentials.

Testing It Out

Now, if you press play and click the button, it should start the OAuth flow! You’ll be redirected to your browser to log in and authorize the game. There will be some logging to the console, but the status won’t change yet.

Troubleshooting

Make sure you’ve uncommented loginButton.onClick.AddListener(StartOAuthFlow); if the button doesn’t seem to do anything
Double check your ClientId is correct
Ensure you’ve added the redirect URL in your Discord Developer Portal
Check the console for specific error messages

DiscordManager.cs up to this point

using UnityEngine;
using UnityEngine.UI;
using Discord.Sdk;
using System.Linq;

public class DiscordManager : MonoBehaviour
{
    [SerializeField] 
    private ulong clientId; // Set this in the Unity Inspector from the dev portal
    
    [SerializeField]
    private Button loginButton; 
    
    [SerializeField] 
    private Text statusText;

    private Client client;
    private string codeVerifier;

        void Start()
    {
        client = new Client();

        // Modifying LoggingSeverity will show you more or less logging information
        client.AddLogCallback(OnLog, LoggingSeverity.Error);
        client.SetStatusChangedCallback(OnStatusChanged);

        // Make sure the button has a listener
        if (loginButton != null)
        {
            loginButton.onClick.AddListener(StartOAuthFlow);
        }
        else
        {
            Debug.LogError("Login button reference is missing, connect it in the inspector!");
        }

        // Set initial status text
        if (statusText != null)
        {
            statusText.text = "Ready to login";
        }
        else
        {
            Debug.LogError("Status text reference is missing, connect it in the inspector!");
        }
    }

    private void OnLog(string message, LoggingSeverity severity)
    {
        Debug.Log($"Log: {severity} - {message}");
    }

    private void OnStatusChanged(Client.Status status, Client.Error error, int errorCode)
    {
        Debug.Log($"Status changed: {status}");
        statusText.text = status.ToString();
        if(error != Client.Error.None)
        {
            Debug.LogError($"Error: {error}, code: {errorCode}");
        }
    }
    
    private void StartOAuthFlow() {
        var authorizationVerifier = client.CreateAuthorizationCodeVerifier();
        codeVerifier = authorizationVerifier.Verifier();
        
        var args = new AuthorizationArgs();
        args.SetClientId(clientId);
        args.SetScopes(Client.GetDefaultPresenceScopes());
        args.SetCodeChallenge(authorizationVerifier.Challenge());
        client.Authorize(args, OnAuthorizeResult);
    }

    private void OnAuthorizeResult(ClientResult result, string code, string redirectUri) {
        Debug.Log($"Authorization result: [{result.Error()}] [{code}] [{redirectUri}]");
        if (!result.Successful()) {
            return;
        }
        GetTokenFromCode(code, redirectUri);
    }

    private void GetTokenFromCode(string code, string redirectUri) {
        client.GetToken(clientId,
                        code,
                        codeVerifier,
                        redirectUri,
                        (result, token, refreshToken, tokenType, expiresIn, scope) => {});
    }
}

Step 8: Connect the SDK to Discord

Now that we have our access token, let’s connect to Discord! To start, we’ll add this code to your DiscordManager.cs:

private void OnReceivedToken(string token) {
    Debug.Log("Token received: " + token);
    client.UpdateToken(AuthorizationTokenType.Bearer, token, (ClientResult result) => { client.Connect(); });
}

private void OnRetrieveTokenFailed() { statusText.text = "Failed to retrieve token"; }

Then we’ll update GetTokenFromCode to call these functions when it completes:

private void GetTokenFromCode(string code, string redirectUri) {
    client.GetToken(clientId,
                    code,
                    codeVerifier,
                    redirectUri,
                    (result, token, refreshToken, tokenType, expiresIn, scope) => {
                        if (token != "") {
                            OnReceivedToken(token);
                        } else {
                            OnRetrieveTokenFailed();
                        }
                    });
}

What’s Happening Here?

Client::UpdateToken tells the SDK to use our access token for Discord API calls
Once the token is updated, we call Client::Connect in the callback
The SDK will begin connecting asynchronously
Our status text will tell you when the SDK is ready!

Testing the Connection

Press play and click the button again to log in and authorize the game. This time you should see the status text change as it goes through the OAuth flow, and it should end up Ready

Troubleshooting

If you don’t see Ready status:

Check that your access token is valid
Ensure you have internet connectivity
Look for error messages from the SDK in the console
Verify your ClientID set in the inspector is correct

DiscordManager.cs up to this point

using UnityEngine;
using UnityEngine.UI;
using Discord.Sdk;
using System.Linq;

public class DiscordManager : MonoBehaviour
{
    [SerializeField] 
    private ulong clientId; // Set this in the Unity Inspector from the dev portal
    
    [SerializeField]
    private Button loginButton; 
    
    [SerializeField] 
    private Text statusText;

    private Client client;
    private string codeVerifier;

        void Start()
    {
        client = new Client();

        // Modifying LoggingSeverity will show you more or less logging information
        client.AddLogCallback(OnLog, LoggingSeverity.Error);
        client.SetStatusChangedCallback(OnStatusChanged);

        // Make sure the button has a listener
        if (loginButton != null)
        {
            loginButton.onClick.AddListener(StartOAuthFlow);
        }
        else
        {
            Debug.LogError("Login button reference is missing, connect it in the inspector!");
        }

        // Set initial status text
        if (statusText != null)
        {
            statusText.text = "Ready to login";
        }
        else
        {
            Debug.LogError("Status text reference is missing, connect it in the inspector!");
        }
    }

    private void OnLog(string message, LoggingSeverity severity)
    {
        Debug.Log($"Log: {severity} - {message}");
    }

    private void OnStatusChanged(Client.Status status, Client.Error error, int errorCode)
    {
        Debug.Log($"Status changed: {status}");
        statusText.text = status.ToString();
        if(error != Client.Error.None)
        {
            Debug.LogError($"Error: {error}, code: {errorCode}");
        }
    }

    private void StartOAuthFlow() {
        var authorizationVerifier = client.CreateAuthorizationCodeVerifier();
        codeVerifier = authorizationVerifier.Verifier();
        
        var args = new AuthorizationArgs();
        args.SetClientId(clientId);
        args.SetScopes(Client.GetDefaultPresenceScopes());
        args.SetCodeChallenge(authorizationVerifier.Challenge());
        client.Authorize(args, OnAuthorizeResult);
    }

    private void OnAuthorizeResult(ClientResult result, string code, string redirectUri) {
        Debug.Log($"Authorization result: [{result.Error()}] [{code}] [{redirectUri}]");
        if (!result.Successful()) {
            return;
        }
        GetTokenFromCode(code, redirectUri);
    }

    private void GetTokenFromCode(string code, string redirectUri) {
        client.GetToken(clientId,
                        code,
                        codeVerifier,
                        redirectUri,
                        (result, token, refreshToken, tokenType, expiresIn, scope) => {
                            if (token != "") {
                                OnReceivedToken(token);
                            } else {
                                OnRetrieveTokenFailed();
                            }
                        });
    }

    private void OnReceivedToken(string token) {
        Debug.Log("Token received: " + token);
        client.UpdateToken(AuthorizationTokenType.Bearer, token, (ClientResult result) => { client.Connect(); });
    }

    private void OnRetrieveTokenFailed() { statusText.text = "Failed to retrieve token"; }
}

Now that your client is in a ready state, we can start implementing Discord social features.

Step 9: Access Discord Relationships

Let’s access the user’s Discord relationships (friends list) and display the count. This will help you understand how to access and use Discord data in your game. Lets add some new code to your DiscordManager.cs:

private void ClientReady()
{
    Debug.Log($"Friend Count: {client.GetRelationships().Count()}");
}

We want to call this when the client is ready to use which we’ll know in our OnStatusChanged method:

private void OnStatusChanged(Client.Status status, Client.Error error, int errorCode)
{
    Debug.Log($"Status changed: {status}");
    statusText.text = status.ToString();
    if(error != Client.Error.None)
    {
        Debug.LogError($"Error: {error}, code: {errorCode}");
    }

    if (status == Client.Status.Ready)
    {
        ClientReady();
    }
}

What This Code Does

When the client status is Ready, it’ll call our ClientReady function, which will call Client::GetRelationships, returning us a list of all the player’s friends. We then log the number of friends directly to the console.

Testing It Out

Hit play and then click the button. Once the OAuth flow completes and you see the status hit Ready check the console to see the output!

Example Output

Friend Count: 42

Troubleshooting

Verify your OAuth2 scopes include relationships access
Ensure you’re connected (status is Ready)
Check that you have friends on Discord
Look for errors in the logging callback

Next, we’ll learn how to show your game’s activity on Discord with Rich Presence!

DiscordManager.cs up to this point

using UnityEngine;
using UnityEngine.UI;
using Discord.Sdk;
using System.Linq;

public class DiscordManager : MonoBehaviour
{
    [SerializeField] 
    private ulong clientId; // Set this in the Unity Inspector from the dev portal
    
    [SerializeField]
    private Button loginButton; 
    
    [SerializeField] 
    private Text statusText;

    private Client client;
    private string codeVerifier;

        void Start()
    {
        client = new Client();

        // Modifying LoggingSeverity will show you more or less logging information
        client.AddLogCallback(OnLog, LoggingSeverity.Error);
        client.SetStatusChangedCallback(OnStatusChanged);

        // Make sure the button has a listener
        if (loginButton != null)
        {
            loginButton.onClick.AddListener(StartOAuthFlow);
        }
        else
        {
            Debug.LogError("Login button reference is missing, connect it in the inspector!");
        }

        // Set initial status text
        if (statusText != null)
        {
            statusText.text = "Ready to login";
        }
        else
        {
            Debug.LogError("Status text reference is missing, connect it in the inspector!");
        }
    }

    private void OnLog(string message, LoggingSeverity severity)
    {
        Debug.Log($"Log: {severity} - {message}");
    }

    private void OnStatusChanged(Client.Status status, Client.Error error, int errorCode)
    {
        Debug.Log($"Status changed: {status}");
        statusText.text = status.ToString();
        if(error != Client.Error.None)
        {
            Debug.LogError($"Error: {error}, code: {errorCode}");
        }

        if (status == Client.Status.Ready)
        {
            ClientReady();
        }
    }

    private void ClientReady()
    {
        Debug.Log($"Friend Count: {client.GetRelationships().Count()}");
    }


    private void StartOAuthFlow() {
        var authorizationVerifier = client.CreateAuthorizationCodeVerifier();
        codeVerifier = authorizationVerifier.Verifier();
        
        var args = new AuthorizationArgs();
        args.SetClientId(clientId);
        args.SetScopes(Client.GetDefaultPresenceScopes());
        args.SetCodeChallenge(authorizationVerifier.Challenge());
        client.Authorize(args, OnAuthorizeResult);
    }

    private void OnAuthorizeResult(ClientResult result, string code, string redirectUri) {
        Debug.Log($"Authorization result: [{result.Error()}] [{code}] [{redirectUri}]");
        if (!result.Successful()) {
            return;
        }
        GetTokenFromCode(code, redirectUri);
    }

    private void GetTokenFromCode(string code, string redirectUri) {
        client.GetToken(clientId,
                        code,
                        codeVerifier,
                        redirectUri,
                        (result, token, refreshToken, tokenType, expiresIn, scope) => {
                            if (token != "") {
                                OnReceivedToken(token);
                            } else {
                                OnRetrieveTokenFailed();
                            }
                        });
    }

    private void OnReceivedToken(string token) {
        Debug.Log("Token received: " + token);
        client.UpdateToken(AuthorizationTokenType.Bearer, token, (ClientResult result) => { client.Connect(); });
    }

    private void OnRetrieveTokenFailed() { statusText.text = "Failed to retrieve token"; }
}

Step 10: Set Rich Presence

Let’s show your game’s activity on Discord using Rich Presence. This feature lets players see what others are doing in your game directly in their Discord friends list. Update your ClientReady method with this code:

private void ClientReady()
{
    Debug.Log($"Friend Count: {client.GetRelationships().Count()}");

    Activity activity = new Activity();
    activity.SetType(ActivityTypes.Playing);
    activity.SetState("In Competitive Match");
    activity.SetDetails("Rank: Diamond II");
    client.UpdateRichPresence(activity, (ClientResult result) => {
        if (result.Successful()) {
            Debug.Log("Rich presence updated!");
        } else {
            Debug.LogError("Failed to update rich presence");
        }
    });
}

What This Code Does

Creates an Activity object to represent what the player is doing
Sets basic information like:

The activity type (Playing)
Current state (“In Competitive Match”)
Additional details (“Rank: Diamond II”)

Updates your rich presence on Discord

Testing It Out

Hit play and then click the button. Once the OAuth flow is complete, you will see the status hit Ready. The console will tell you if setting rich presence was successful, and you can check your Discord profile to see it!

Troubleshooting

If you don’t see your presence:

Ensure you’re connected (status is Ready)
Check the console for error messages
Verify your activity settings are valid
Make sure you’re not invisible on Discord

The full DiscordManager.cs

using UnityEngine;
using UnityEngine.UI;
using Discord.Sdk;
using System.Linq;

public class DiscordManager : MonoBehaviour
{
    [SerializeField] 
    private ulong clientId; // Set this in the Unity Inspector from the dev portal
    
    [SerializeField]
    private Button loginButton; 
    
    [SerializeField] 
    private Text statusText;

    private Client client;
    private string codeVerifier;

        void Start()
    {
        client = new Client();

        // Modifying LoggingSeverity will show you more or less logging information
        client.AddLogCallback(OnLog, LoggingSeverity.Error);
        client.SetStatusChangedCallback(OnStatusChanged);

        // Make sure the button has a listener
        if (loginButton != null)
        {
            loginButton.onClick.AddListener(StartOAuthFlow);
        }
        else
        {
            Debug.LogError("Login button reference is missing, connect it in the inspector!");
        }

        // Set initial status text
        if (statusText != null)
        {
            statusText.text = "Ready to login";
        }
        else
        {
            Debug.LogError("Status text reference is missing, connect it in the inspector!");
        }
    }

    private void OnLog(string message, LoggingSeverity severity)
    {
        Debug.Log($"Log: {severity} - {message}");
    }

    private void OnStatusChanged(Client.Status status, Client.Error error, int errorCode)
    {
        Debug.Log($"Status changed: {status}");
        statusText.text = status.ToString();
        if(error != Client.Error.None)
        {
            Debug.LogError($"Error: {error}, code: {errorCode}");
        }

        if (status == Client.Status.Ready)
        {
            ClientReady();
        }
    }

    private void ClientReady()
    {
            Debug.Log($"Friend Count: {client.GetRelationships().Count()}");

            Activity activity = new Activity();
            activity.SetType(ActivityTypes.Playing);
            activity.SetState("In Competitive Match");
            activity.SetDetails("Rank: Diamond II");
            client.UpdateRichPresence(activity, (ClientResult result) => {
                if (result.Successful()) {
                    Debug.Log("Rich presence updated!");
                } else {
                    Debug.LogError("Failed to update rich presence");
                }
            });
    }

    private void StartOAuthFlow() {
        var authorizationVerifier = client.CreateAuthorizationCodeVerifier();
        codeVerifier = authorizationVerifier.Verifier();
        
        var args = new AuthorizationArgs();
        args.SetClientId(clientId);
        args.SetScopes(Client.GetDefaultPresenceScopes());
        args.SetCodeChallenge(authorizationVerifier.Challenge());
        client.Authorize(args, OnAuthorizeResult);
    }

    private void OnAuthorizeResult(ClientResult result, string code, string redirectUri) {
        Debug.Log($"Authorization result: [{result.Error()}] [{code}] [{redirectUri}]");
        if (!result.Successful()) {
            return;
        }
        GetTokenFromCode(code, redirectUri);
    }

    private void GetTokenFromCode(string code, string redirectUri) {
        client.GetToken(clientId,
                        code,
                        codeVerifier,
                        redirectUri,
                        (result, token, refreshToken, tokenType, expiresIn, scope) => {
                            if (token != "") {
                                OnReceivedToken(token);
                            } else {
                                OnRetrieveTokenFailed();
                            }
                        });
    }

    private void OnReceivedToken(string token) {
        Debug.Log("Token received: " + token);
        client.UpdateToken(AuthorizationTokenType.Bearer, token, (ClientResult result) => { client.Connect(); });
    }

    private void OnRetrieveTokenFailed() { statusText.text = "Failed to retrieve token"; }
}

Conclusion

Congratulations! You’ve successfully integrated the Discord Social SDK into Unity. Let’s review what you’ve accomplished:

What You’ve Built

✅ Created a Discord application and configured OAuth2
✅ Set up SDK logging and status monitoring
✅ Implemented user authentication flow
✅ Retrieved Discord relationships data
✅ Added Rich Presence support

Key Concepts Learned

How to initialize and configure the Discord SDK
Managing authentication and connections
Working with Discord’s social features
Handling asynchronous callbacks
Monitoring SDK status and events

Next Steps

Check out our in depth sample for using the Social SDK in Unity following the best practices laid out in these guides. It contains easy to drop in prefabs with both code and UI to quickly integrate Discord’s social features into your game.

Video showing off the Unity sample with the Discord Social SDK

Creating a Unified Friends List

Create a unified friends list combining Discord and game-specific friendships

Setting Rich Presence

Customize your game’s rich presence to show more advanced information and game invites

Managing Game Invites

Allow players to invite friends to join their game session or party.

Need help? Join the Discord Developers Server and share questions in the #social-sdk-dev-help channel for support from the community. If you encounter a bug while working with the Social SDK, please report it here: https://dis.gd/social-sdk-bug-report

Change Log

Date	Changes
March 17, 2025	Initial release

Home

Quick Start

Interactions

Components

Activities

Discord Social SDK

Rich Presence

Monetization

Discovery

Events

Developer Tools

Resources

Topics

Tutorials

Policies and Agreements

​Overview

​Prerequisites

​Step 1: Create a Discord Developer Team

​Step 2: Create a Discord Application

​Step 3: Enable Discord Social SDK for Your App

​Step 4: Download the Social SDK for Unity

​Step 5: Project Setup

​Troubleshooting

​Step 6: Setting Up SDK Event Handling

​What These Callbacks Do

​Step 7: Account Linking with Discord

​Add the Authentication Code

​What’s Happening Here?

​Testing It Out

​Troubleshooting

​Step 8: Connect the SDK to Discord

​What’s Happening Here?

​Testing the Connection

​Troubleshooting

​Step 9: Access Discord Relationships

​What This Code Does

​Testing It Out

​Example Output

​Troubleshooting

​Step 10: Set Rich Presence

​What This Code Does

​Testing It Out

​Troubleshooting

​Conclusion

​What You’ve Built

​Key Concepts Learned

​Next Steps

​Social SDK Unity sample

Creating a Unified Friends List

Setting Rich Presence

Managing Game Invites

​Change Log

Overview

Prerequisites

Step 1: Create a Discord Developer Team

Step 2: Create a Discord Application

Step 3: Enable Discord Social SDK for Your App

Step 4: Download the Social SDK for Unity

Step 5: Project Setup

Troubleshooting

Step 6: Setting Up SDK Event Handling

What These Callbacks Do

Step 7: Account Linking with Discord

Add the Authentication Code

What’s Happening Here?

Testing It Out

Troubleshooting

Step 8: Connect the SDK to Discord

What’s Happening Here?

Testing the Connection

Troubleshooting

Step 9: Access Discord Relationships

What This Code Does

Testing It Out

Example Output

Troubleshooting

Step 10: Set Rich Presence

What This Code Does

Testing It Out

Troubleshooting

Conclusion

What You’ve Built

Key Concepts Learned

Next Steps

Social SDK Unity sample

Change Log