Google One Tap Login For Magento 2 - User Guide

Step 1: Create or Select a Google Cloud Project

1. Open the Google Cloud Console Clients page: https://console.developers.google.com/
2. Create a new project or select an existing project that will be used for this storefront login integration.
3. If prompted, switch to the correct project before creating credentials.

Step 2: Configure OAuth Branding / Consent Screen

Google Identity Services requires OAuth branding details before production use.

1. Open the Google Auth Platform branding or OAuth consent screen area in Google Cloud Console.
2. Fill in the required application information:
   • application name
   • support email
   • authorized domains
   • application homepage URL
   • privacy policy URL
   • terms of service URL if available
3. Save the branding settings.
4. Review scopes if Google asks for them.

For standard authentication with profile and email, sensitive extra scopes are not required.

Step 3: Create the Google Client ID

1. Open the credentials or clients page for the selected project.
2. Create a new OAuth client.
3. Choose application type: Web application.
4. Give the client a recognizable name, for example: Magento Storefront One Tap

Step 4: Add Authorized JavaScript Origins

In the Google client configuration, add every storefront origin that should use One Tap.

Examples:

https://www.example.com
https://example.com
https://store.example.com

Important rules:

• Enter the scheme and hostname only.
• Do not add paths for JavaScript origins.
• Production One Tap should use HTTPS.
• If you use multiple domains or subdomains, add each one explicitly.

For local testing, Google allows localhost origins such as:

http://localhost
http://localhost:8080

Step 5: Copy the Google Client ID

After saving the client, Google shows a client ID similar to:

123456789012-abcdef1234567890abcdef123456.apps.googleusercontent.com

Copy this value. You will paste it into Magento in the next steps.

Step 6: Configure the Module in Magento

In Magento Admin, go to:

Stores > Configuration > Eleventex > Google One Tap Login

Configure the fields in General:

Enable Module

Set to Yes to allow the One Tap integration to run on the storefront.

License Key

Paste the Eleventex license key for this module.

Google Client ID

Paste the Google OAuth client ID created in Google Cloud Console.

Auto Create Customer

Choose how unmatched Google users are handled:

• Yes: Magento creates a new customer account when no existing customer is found for the verified email.
• No: only existing customers can sign in.

Enable Debug Logging

Set to Yes only when troubleshooting configuration or validation issues.

Step 7: Save Config and Refresh Magento Cache

After saving the configuration, refresh Magento caches if needed:

bin/magento cache:flush

If this is the first time the module is installed, also run:

bin/magento setup:upgrade

Step 8: Test the Storefront Flow

Use a guest browser session or private window.

Existing Customer Test

1. Open the storefront as a guest.
2. Wait for the Google One Tap prompt to appear.
3. Choose a Google account whose verified email already exists as a Magento customer in the same website.
4. Confirm the customer is logged in successfully.

Expected result:

• Magento logs the customer in
• the Google account becomes linked for future sign-ins

New Customer Test

This test applies only when Auto Create Customer is enabled.

1. Open the storefront as a guest.
2. Use a Google account with a verified email that does not yet exist in Magento.
3. Complete the One Tap sign-in.

Expected result:

• Magento creates a new customer account
• the new customer is logged in
• the Google identity is linked to that customer

Troubleshooting

One Tap does not appear

Check:

• the module is enabled
• you are not already logged in
• Magento frontend customer-data has updated after login/logout state changes
• you are not testing on checkout
• the Google Client ID is filled in
• the storefront is using a valid allowed origin
• browser pop-up or privacy settings are not blocking Google Identity Services

Important:

• the module uses Magento frontend customer-data to decide whether the current visitor is a guest or an authenticated customer
• if the user clicks the X on the Google One Tap prompt, Google may suppress the prompt for a cooldown period
• during that period, the prompt may stay hidden even after logout, refresh, or a later visit in the same browser context
• this is expected Google One Tap behavior and does not necessarily mean the Magento module is broken
• Google also decides final One Tap eligibility in the browser, so a guest session with correct Magento configuration may still not always receive the prompt immediately
• for retesting, use a fresh private window, another browser profile, or wait until Google allows the prompt to display again

Google origin mismatch or client ID errors

Check the Google Cloud client configuration:

• the storefront origin must be listed in Authorized JavaScript Origins
• the configured client ID in Magento must match the project and client you created

Works on localhost but not on production

Check:

• production uses HTTPS
• the production domain is added as an Authorized JavaScript Origin
• the Magento base URL matches the domain configured in Google Cloud

Customer is not created

Check:

• Auto Create Customer is set to Yes
• the Google account has a verified email
• there is no existing conflicting customer or identity link

Prompt stopped appearing after config changes

Run:

bin/magento cache:clean
bin/magento cache:flush

Then open the storefront in a fresh guest session.

Need more diagnostic detail

Temporarily enable:

• Enable Debug Logging = Yes

After troubleshooting, disable it again unless you actively need additional logging.

Official Google References

Google’s current setup guidance for Sign in with Google / One Tap:

• Setup and client ID creation: https://developers.google.com/identity/gsi/web/guides/get-google-api-clientid
• Server-side token verification: https://developers.google.com/identity/gsi/web/guides/verify-google-id-token