Basic components
Google One-Tap Login

Google One-tap delivers a seamless experience with a small pop-up that can authenticate a user with a streamlined interface. The customer should be able to use this feature as follows:

  1. Google One-tap pop-up is presented. [1]
  2. The User clicks on the Continue as button.
  3. Google checks the user's identity.
  4. The store refreshes itself or redirects the user (if on /login page) to the homepage.

{"base64":"  ","img":{"width":640,"height":436,"type":"gif","mime":"image/gif","wUnits":"px","hUnits":"px","length":7993508,"url":""}}


In VTEX stores, the One-tap flow is implemented by the vtex.login app. A more complete description of how that is done goes as follows:

  1. vtex.login checks whether the user is logged in or not (it only starts the One-tap flow for unsigned users).
  2. vtex.login calls our ID API to get the store's OAuth clientId.
  3. vtex.login triggers the One-tap pop-up. [2]
  4. The User clicks on the Continue as button.
  5. Google checks the user identity and returns a JWT to vtex.login.
  6. vtex.login executes a Form POST containing the JWT and redirecting the user to an endpoint at our ID API.
  7. The API validates the JWT and redirects the user back to the website.

1: The pop-up that appears on non-login pages of the webstore can only be closed by clicking the x button on the top corner of the pop-up and will not auto-signin users.

2: If the user has already signed-up using One-tap once and is on the /login page, the One-tap auto_select option is turned on and the user is automatically signed-in and redirected.


There are a few steps required to correctly configure One-tap in a store:

  • Configuring the Google OAuth 2.0 integration.
  • Setting up the Google OAuth 2.0 app
  • Enabling the feature on VTEX ID.
  • Setting up the Google One-tap pop-up on Site Editor.

Configuring the Google OAuth 2.0 integration

The One-Tap flow requires the store to have Google OAuth login already set up. This can be done by following this tutorial on our help center.

Setting up the Google OAuth 2.0 app

All web store domains must be added to the Authorized domains list on the Google OAuth 2.0 configuration page, inside Google Developers Console.

{"base64":"  ","img":{"width":469,"height":134,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":19152,"url":""}}

Note: We advise clients to add both their website domain and also the {{accountName}} domain, as our restricted domain can be used for testing.

You can check Configure your OAuth Consent Screen and Setting up OAuth 2.0 for more details on how to set up the Google OAuth app.

Enabling the store on VTEX ID

This is an experimental feature that requires special configuration inside VTEX ID, our authentication service. So, for it to work properly you need to ask your Account Manager to enable it or create a support ticket requesting it.

Setting up One-tap on Site Editor

This step does not depend on the previous one, meaning it can be done before enabling the feature on VTEX ID, but it won't work properly.

As of vtex.login@2.31.x there's a new section on the Login submenu of the Site Editor

{"base64":"  ","img":{"width":1067,"height":752,"type":"gif","mime":"image/gif","wUnits":"px","hUnits":"px","length":795845,"url":""}}

Under this section, you can enable Google One-tap on their stores and also configure in which side of the page it appears in (Google One-tap alignment) and the top margin of the pop-up (Google One-tap top margin).

Note: The Google One-tap top margin configuration accepts the same values as the CSS property top accepts.

Photo of the contributor
+ 1 contributors
Was this helpful?
Suggest edits (Github)
Photo of the contributor
+ 1 contributors
On this page