Last updated

Google login

To enable users to log in with Google, first activate Google login in the builder and then set up an application with Google to serve as the OAuth provider.


Follow these steps for a smooth integration.

Step 1: Enabling Google social login in builder

  1. Navigate to Home and open the Login Box builder.
  2. In the left panel, toggle Google to on.

test


After modifying any settings, commit your changes and publish them to apply across your environments.

Step 2: Creating a Google app

Complete the steps below to configure Google login.

Moving between environments

When migrating a project between environments (e.g., from development to production), Frontegg automatically transfers your social login settings.

Step 3: Open project on Google developers console

  1. Visit the Google Developers Console.
  2. In the top dropdown, select your project.

Step 4: Create credentials

  1. Open the Credentials menu, select Create Credentials, and choose OAuth Client ID.
  2. Set up the consent screen by selecting your user type (if prompted), then click Create.

test

test

  1. On the App Information page, enter your application name, user support email, and developer contact email, completing the remaining required fields and sections.

test

Important

If you’re using Frontegg’s hosted login without a custom domain, Google will show “to continue to frontegg.com” on the login screen. Using a custom domain or the embedded login feature displays "to continue to YOUR_APP_NAME."

Step 5: Create a client ID

  1. Return to the Credentials menu to create an OAuth2 Client ID.

test

  1. Select Web Application as the Application Type.
  2. For Authorized JavaScript Origins, add your app’s URI (e.g., http://localhost:3000).
  3. For Authorized redirect URIs:
    • If you are using the Hosted login method, your Redirect URL should be:
      https://[YOUR-FRONTEGG-DOMAIN].frontegg.com/oauth/account/social/success.
    • If you are using the Embedded Login method, the Redirect URL should be:
      https://[YOUR-APP-URL]/account/social/success, for example: http://localhost:3000/account/social/success.

test

Step 6: Enter Google credentials in Frontegg

  1. Copy the Client ID and Client Secret from Google.

test

  1. Open the Frontegg portal.
  2. Navigate to [ENVIRONMENT] ➜ Configurations → Authentication → Social logins in the sidebar.
  3. Click the Manage button under Google, enter the Client ID, Client Secret, and Redirect URL, then save and publish your changes.

test

Step 7: Test the Google login button

  1. On your login screen, confirm that the Google button appears and correctly redirects to the Google OAuth consent screen.
  2. Test it to ensure functionality.

test

Configuring Google Login Permissions

By default, only invited users can log in with Google. To allow new users to sign up via Google, enable Allow Signup in the Login Box builder's left panel.


Customizing authentication scopes

Scopes define what user information your application can access. Frontegg’s default scopes include user profile, email and OpenID. To add more scopes:

  1. Open the Frontegg portal.
  2. Navigate to [ENVIRONMENT] ➜ Configurations → Authentication → Social logins in the sidebar.
  3. Click the Google manage button, select Custom, and enter the additional scopes you need under Scopes.
  4. For a list of available options, refer to Google's supported scopes.

Enabling Google one tap

Frontegg’s login dialog supports Google One Tap on compatible browsers by default for both hosted and embedded login. To enable Google One Tap:

  1. Go to your Google Developers Console.
  2. In your OAuth project, add the following to Authorized JavaScript Origins:
    • For hosted login mode: https://[YOUR-FRONTEGG-DOMAIN]
    • For embedded login mode: https://[YOUR-APP-URL]
    • For local testing, add http://localhost (e.g., http://localhost:[PORT]).