Login with Discord

To enable Discord Auth for your project, you need to set up a Discord Application and add the Application OAuth credentials to your Supabase Dashboard.

Overview#

Setting up Discord logins for your application consists of 3 parts:

Access your Discord account#

  • Go to discord.com.
  • Click on Login at the top right to log in.

Discord Portal.

Discord Portal.

Find your callback URL#

In the next step you require a callback URL, which looks like this:

https://<project-ref>.supabase.co/auth/v1/callback

  • Go to your Supabase Project Dashboard.
  • Click on the Settings icon at the bottom of the left sidebar.
  • Click on API in the list.
  • Under Config / URL you'll find your API URL, you can click Copy to copy it to the clipboard.
  • Now just add /auth/v1/callback to the end of that to get your full OAuth Redirect URI.

Create a Discord Application#

  • Click on New Application at the top right.
  • Enter the name of your application and click Create.
  • Click on OAuth2 under Settings in the left side panel.
  • Click Add Redirect under Redirects.
  • Type or paste your callback URL into the Redirects box.
  • Click Save Changes at the bottom.
  • Copy your Client ID and Client Secret under Client information.

Add your Discord credentials into your Supabase Project#

  • Go to your Supabase Project Dashboard
  • In the left sidebar, click the Authentication icon (near the top)
  • Click Settings from the list to go to the Authentication Settings page
  • Enter the final (hosted) URL of your app under Site URL (this is important)
  • Under External OAuth Providers turn Discord Enabled to ON
  • Enter your client_id and client_secret saved in the previous step
  • Click Save

Add login code to your client app#

When your user signs in, call signInWithOAuth() with discord as the provider:

1async function signInWithDiscord() {
2  const { data, error } = await supabase.auth.signInWithOAuth({
3    provider: 'discord',
4  })
5}

If your user is already signed in, Discord prompts the user again for authorization.

When your user signs out, call signOut() to remove them from the browser session and any objects from localStorage:

1async function signout() {
2  const { error } = await supabase.auth.signOut()
3}

Resources#