Set up Discord as an identity provider

Last updated on August 5, 2026

Overview​

This guide helps verified Discord developers connect Discord accounts to AccelByte Gaming Services (AGS). You may need to set up additional features within Discord services that we haven't listed here. For more information about setting up Discord services, we recommend contacting your Discord representative and reviewing Discord documentation.

important

This guide is intended for public use and contains limited information due to confidentiality. We recommend you refer to the full confidential guide first. To request a copy of the confidential guide, contact your AccelByte Technical Producer.

Goals​

  • Enable the Discord authentication method for your publisher website with the AGS Player Portal.
  • Enable the Discord authentication method for your game using the AGS SDK.

Prerequisites​

  • A Discord developer account. Visit Discord Developer Portal for details.
  • An AGS Admin Portal account to set up authentication and manage permissions.
  • A publisher namespace for your Player Portal and Launcher, and a game namespace for your game.
  • A Player Portal.

Set up the Discord application​

Create a Discord application​

Create a Discord application. To do this, you can follow the Creating an app guide.

Set up Discord OAuth2​

Set up your Discord OAuth2. Generate an OAuth2 Client Secret and save it. Also, add these URIs to your OAuth2 Redirect URLs for the authentication process:

  • https://<BaseURL>
  • https://<BaseURL>/iam/v3/platforms/discord/authenticate
  • https://<BaseURL>/iam/v3/public/namespaces/<namespace>/users/me/platforms/discord/web/link/establish

The BaseURL is your domain address, e.g., https://development.accelbyte.io.

Read the Discord OAuth2 documentation for more details.

Set up a web login for Discord​

AGS Public Cloud

Web login integration is currently unavailable in AGS Public Cloud and is only supported in AGS Private Cloud.

Configuration steps​

Use the following steps to set up Discord logins in the player portal. This will allow your players to sign in to your player portal using their Discord accounts.

  1. In the AGS Admin portal, go to your publisher namespace.

  2. On the sidebar menu, go to Foundations > 3rd Party Integrations > Auth & Account Linking.

  3. On the Auth & Account Linking page, click + Add New.

    Click add new login method

  4. On the Select login provider page, from the Social tab, select Discord.

    click discord login method

  5. The Set Up Discord login provider dialog appears. Fill in the following fields:

    • Platform ID: discord. Set automatically. Cannot be changed.
    • Client ID: The Discord App Client ID.
    • Client Secret: The Discord App Client Secret.
    • Redirect URI: The <BaseURL> (BaseURL is your domain address, e.g., https://development.accelbyte.io).

    configuring new login method

  6. Click Add & Activate to create and activate the provider in one step. Alternatively, click Add to create without activating.

Edit a login provider​

  1. On the Auth & Account Linking page, click the Discord provider.

  2. The Discord login provider dialog appears. Update the fields as needed.

    Image shows the Discord login provider dialog with the Active toggle

  3. Use the Status toggle at the top to activate or deactivate the provider.

  4. Click Save.

Give it a try​

Make sure you've already set up the Discord login method in the publisher namespace.

  1. Go to your Player Portal and click Login.

    click login on your player portal

  2. Click the Discord icon. If you can't find it, click More login options. click discord icon on your player portal

  3. The system redirects you to the Discord login page. Fill in your Discord credentials to proceed.

That's it! You've completed the required steps.

discord login page

note

The system asks players to link their Discord account with an existing or new AccelByte account. AccelByte is working to make this configurable, so that players can log in to the Player Portal with a headless account.

Set up in-game login for Discord​

Use the following steps to set up Discord logins for your game. This allows your players to sign in to your game using their Discord accounts.

important

On AGS Public Cloud (Shared Cloud), AGS does not redirect the player through Discord for in-game login. Your game client must implement the Discord OAuth integration itself to obtain the authorization code, then pass that code to AGS. On AGS Private Cloud, this constraint doesn't apply.

  1. In the AGS Admin Portal, go to your game namespace.

  2. On the sidebar menu, go to Foundations > 3rd Party Integrations > Auth & Account Linking.

  3. On the Auth & Account Linking page, click + Add New.

  4. From the list of login method options, select Discord.

  5. The Set up Discord login provider form appears. Fill in the following fields:

    • Platform ID: discord. Set automatically. Cannot be changed.
    • Client ID: The Discord App Client ID.
    • Client Secret: The Discord App Client Secret.
    • Redirect URI: http://127.0.0.1.

  6. Click Add & Activate to create and activate the provider in one step. Alternatively, click Add to create without activating.

Edit a login provider​

  1. On the Auth & Account Linking page, click the Discord provider.

  2. The Discord login provider dialog appears. Update the fields as needed.

  3. Use the Status toggle at the top to activate or deactivate the provider.

  4. Click Save.

Last updated on
On this page