Login with Google

For web applications, you can set up your signin button two different ways:

• Use your own application code for the button.
• Use Google's pre-built sign-in or OneTap flows.

Application code configuration#

To use your own application code:

1. In the Google Cloud console, go to the Consent Screen configuration page. The consent screen is the view shown to your users when they consent to signing in to your app.

2. Under Authorized domains, add your Supabase project's domain, which has the form <PROJECT_ID>.supabase.co.

3. Configure the following non-sensitive scopes:

   • .../auth/userinfo.email
   • ...auth/userinfo.profile
   • openid

4. Go to the API Credentials page.

5. Click Create credentials and choose OAuth Client ID.

6. For application type, choose Web application.

7. Under Authorized JavaScript origins, add your site URL.

8. Under Authorized redirect URLs, enter the callback URL from the Supabase dashboard. Expand the Google Auth Provider section to display it.

   The redirect URL is visible to your users. You can customize it by configuring custom domains.

9. When you finish configuring your credentials, you will be shown your client ID and secret. Add these to the Google Auth Provider section of the Supabase Dashboard.

   In local development, you can add the client ID and secret to your config.toml file.

Google pre-built configuration#

To use Google's pre-built signin buttons:

1. In the Google Cloud console, go to the Consent Screen configuration page. The consent screen is the view shown to your users when they consent to signing in to your app.
2. Configure the screen to your liking, making sure you add links to your app's privacy policy and terms of service.
3. Go to the API Credentials page.
4. Click Create credentials and choose OAuth Client ID.
5. For application type, choose Web application.
6. Under Authorized JavaScript origins and Authorized redirect URLs, add your site URL. This is the URL of the website where the signin button will appear, not your Supabase project domain. If you're testing in localhost, ensure that you have http://localhost set in the Authorized JavaScript origins section as well. This is important when integrating with Google One-Tap to ensure you can use it locally.
7. When you finish configuring your credentials, you will be shown your client ID. Add this to the Client IDs field in the Google Auth Provider section of the Supabase Dashboard. Leave the OAuth client ID and secret blank. You don't need them when using Google's pre-built approach.

Application code#

To use your own application code for the signin button, call the signInWithOAuth method (or the equivalent for your language).

For an implicit flow, that's all you need to do. The user will be taken to Google's consent screen, and finally redirected to your app with an access and refresh token pair representing their session.

For a PKCE flow, for example in Server-Side Auth, you need an extra step to handle the code exchange. When calling signInWithOAuth, provide a redirectTo URL which points to a callback route. This redirect URL should be added to your redirect allow list.

At the callback endpoint, handle the code exchange to save the user session.

After a successful code exchange, the user's session will be saved to cookies.

Saving Google tokens#

The tokens saved by your application are the Supabase Auth tokens. Your app might additionally need the Google OAuth 2.0 tokens to access Google services on the user's behalf.

On initial login, you can extract the provider_token from the session and store it in a secure storage medium. The session is available in the returned data from signInWithOAuth (implicit flow) and exchangeCodeForSession (PKCE flow).

Google does not send out a refresh token by default, so you will need to pass parameters like these to signInWithOAuth() in order to extract the provider_refresh_token:

Google pre-built#

Most web apps and websites can utilize Google's personalized sign-in buttons, One Tap or automatic sign-in for the best user experience.

1. Load the Google client library in your app by including the third-party script:

   
   

   _10

   <script src="https://accounts.google.com/gsi/client" async></script>

   
   

2. Use the HTML Code Generator to customize the look, feel, features and behavior of the Sign in with Google button.

3. Pick the Swap to JavaScript callback option, and input the name of your callback function. This function will receive a CredentialResponse when sign in completes.

   To make your app compatible with Chrome's third-party-cookie phase-out, make sure to set data-use_fedcm_for_prompt to true.

   Your final HTML code might look something like this:

   
   

   _21

   <div

   _21

   id="g_id_onload"

   _21

   data-client_id="<client ID>"

   _21

   data-context="signin"

   _21

   data-ux_mode="popup"

   _21

   data-callback="handleSignInWithGoogle"

   _21

   data-nonce=""

   _21

   data-auto_select="true"

   _21

   data-itp_support="true"

   _21

   data-use_fedcm_for_prompt="true"

   _21

   ></div>

   _21

   _21

   <div

   _21

   class="g_id_signin"

   _21

   data-type="standard"

   _21

   data-shape="pill"

   _21

   data-theme="outline"

   _21

   data-text="signin_with"

   _21

   data-size="large"

   _21

   data-logo_alignment="left"

   _21

   ></div>

   
   

4. Create a handleSignInWithGoogle function that takes the CredentialResponse and passes the included token to Supabase. The function needs to be available in the global scope for Google's code to find it.

   
   

   _10

   async function handleSignInWithGoogle(response) {

   _10

   const { data, error } = await supabase.auth.signInWithIdToken({

   _10

   provider: 'google',

   _10

   token: response.credential,

   _10

   })

   _10

   }

   
   

5. (Optional) Configure a nonce. The use of a nonce is recommended for extra security, but optional. The nonce should be generated randomly each time, and it must be provided in both the data-nonce attribute of the HTML code and the options of the callback function.

   
   

   _10

   async function handleSignInWithGoogle(response) {

   _10

   const { data, error } = await supabase.auth.signInWithIdToken({

   _10

   provider: 'google',

   _10

   token: response.credential,

   _10

   nonce: '<NONCE>',

   _10

   })

   _10

   }

   
   

   Note that the nonce should be the same in both places, but because Supabase Auth expects the provider to hash it (SHA-256, hexadecimal representation), you need to provide a hashed version to Google and a non-hashed version to signInWithIdToken.

   You can get both versions by using the in-built crypto library:

   
   

   _12

   // Adapted from https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto/digest#converting_a_digest_to_a_hex_string

   _12

   _12

   const nonce = btoa(String.fromCharCode(...crypto.getRandomValues(new Uint8Array(32))))

   _12

   const encoder = new TextEncoder()

   _12

   const encodedNonce = encoder.encode(nonce)

   _12

   crypto.subtle.digest('SHA-256', encodedNonce).then((hashBuffer) => {

   _12

   const hashArray = Array.from(new Uint8Array(hashBuffer))

   _12

   const hashedNonce = hashArray.map((b) => b.toString(16).padStart(2, '0')).join('')

   _12

   })

   _12

   _12

   // Use 'hashedNonce' when making the authentication request to Google

   _12

   // Use 'nonce' when invoking the supabase.auth.signInWithIdToken() method

   
   

One-tap with Next.js#

If you're integrating Google One-Tap with your Next.js application, you can refer to the example below to get started: