Add Discord as a social connection
You will learn the following:
- Use Discord to authenticate users with OAuth
Before you start
Enabling OAuth with Discord allows your users to sign up and sign in to your Clerk application with their Discord account.
Configure for your development instance
For development instances, Clerk uses preconfigured shared OAuth credentials and redirect URIs—no other configuration is needed.
- In the Clerk Dashboard, navigate to the SSO connections page.
- Select Add connection and select For all users.
- In the Choose provider dropdown, select Discord.
- Select Add connection.
Configure for your production instance
For production instances, you must provide custom credentials.
To make the setup process easier, it's recommended to keep two browser tabs open: one for the Clerk Dashboard and one for your Discord Developer Portal.
Enable Discord as a social connection in Clerk
- In the Clerk Dashboard, navigate to the SSO connections page.
- Select Add connection and select For all users.
- In the Choose provider dropdown, select Discord.
- Ensure that both Enable for sign-up and sign-in and Use custom credentials are toggled on.
- Save the Redirect URI somewhere secure. Keep the modal and page open.
Create a Discord Developer app
- On a separate page, go to the Discord Developer Portal and sign in.
- In the top-right, select New Application.
- Complete the required fields and select Create. You'll be redirected to the General Information page.
- In the left sidebar, select OAuth2.
- Under Redirects, select Add Redirect. Paste the Redirect URI you saved from the Clerk Dashboard.
- Select Save Changes. You may need to tap anywhere on the screen for the button to show.
- Save the Client ID and Client Secret somewhere secure. If you don't see the Copy button under the Client Secret, select Reset Secret to generate a new one.
Set the Client ID and Client Secret in the Clerk Dashboard
- Navigate back to the Clerk Dashboard where the modal should still be open. Paste the Client ID and Client Secret values that you saved into the respective fields.
- Select Add connection.
The simplest way to test your connection is to visit your Clerk app's Account Portal, which is available for all Clerk apps out-of-the-box.
- In the Clerk Dashboard, navigate to the Account Portal page.
- Next to the Sign-in URL, select Visit. The URL should resemble:
- For development –
https://your-domain.accounts.dev/sign-in
- For production –
https://accounts.your-domain.com/sign-in
- Sign in with your connection's credentials.
Feedback
Last updated on