Skip to main content
Docs

Add Hugging Face as a social connection

You will learn the following:

  • Use Hugging Face to authenticate users with OAuth

Enabling OAuth with Hugging Face allows your users to sign up and sign in to your Clerk application with their Hugging Face account.

Configure for your development instance

For development instances, Clerk uses preconfigured shared OAuth credentials and redirect URIs — no other configuration is needed.

To configure your development instance, follow these steps:

  1. In the Clerk Dashboard, navigate to the SSO connections page.
  2. Select the Add connection button and select For all users.
  3. In the Choose provider dropdown, select Hugging Face.
  4. Select Add connection.

Configure for your production instance

In production instances, you must provide custom credentials.

To configure your production instance, follow these steps:

Enable Hugging Face as a social connection

  1. In the Clerk Dashboard, navigate to the SSO connections page.
  2. Select the Add connection button and select For all users.
  3. In the Choose provider dropdown, select Hugging Face.
  4. Ensure that both Enable for sign-up and sign-in and Use custom credentials are toggled on.
  5. Save the Redirect URL somewhere secure. Keep this modal and page open.

Create a Hugging Face Connected App

  1. In the top-right of Hugging Face, select your avatar and select Settings.
  2. In the left sidebar, select Connected Apps.
  3. Under Developer Applications, select Create App.
  4. Complete the form. Under Scopes, select the scopes that your app requires. At minimum, select openid, profile, and email. Under Redirect URLs, paste the Redirect URL value you saved from the Clerk Dashboard.
  5. Select Create. The page should refresh and display the Client ID and App Secret. Save these values somewhere secure.

Set the Client ID and App Secret in the Clerk Dashboard

  1. Navigate back to the Clerk Dashboard where the modal should still be open. Paste the Client ID and App Secret values that you saved into the respective fields.
  2. Select Add connection.

Note

If the modal or page is not still open, navigate to the SSO connections page in the Clerk Dashboard. Select the connection. Under Use custom credentials, you can paste the values into their respective fields.

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.

  1. In the Clerk Dashboard, navigate to the Account Portal page.
  2. Next to the Sign-in URL, select Visit. The URL should resemble:
  • For developmenthttps://your-domain.accounts.dev/sign-in
  • For productionhttps://accounts.your-domain.com/sign-in
  1. Sign in with your connection's credentials.

Feedback

What did you think of this content?

Last updated on