Menu
Feedback
Start here
Tutorials
Developer portal

Known Issues
Support Rules
Troubleshooting

Frequently Asked Questions
Announcements
Start here
Tutorials
Explore in-depth tutorials for operating your VTEX store.
Tutorials
VTEX Modules: Getting Started
Accounts & Permissions
Enabling two-factor authentication (2FA)
Enabling two-factor authentication login

Two-Factor Authentication (2FA) is an authentication method that considerably increases the login security in your store.

During the login process, in addition to email and password, the system asks for an extra key (which, on VTEX, can be either an SMS or an app-generated code).

Since this key is generated at login and expires quickly, it is almost impossible for someone to access your store using your credentials without authorization. Without 2FA, someone would only need your email and password to have full access to your store account.

Two-factor authentication (2FA) is mandatory in the VTEX Admin

.

Without 2FA, you won't be able to log in using your email and password.

2FA is not mandatory for other login methods (Google, Facebook, or access code).

In some companies, call center operators are not allowed to use mobile phones. Therefore, users who only have the call center role are not required to enable two-factor authentication.

Enabling 2FA

If you haven’t set up two-factor authentication yet, whenever you access the Admin using your email and password, a screen with 2FA configuration will be displayed.

There are two authentication options:

  • Using a key generated by an authentication app.
  • Using a key sent by SMS.

{"base64":"  ","img":{"width":448,"height":530,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":31548,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Authentication/Two-factor%20authentication/enabling-2-factor-authentication-login_1.png"}}

We strongly recommend choosing the app authentication option, since SMS authentication depends on mobile network provider services. Through the app, the access key will always be available when you need it.

If you've configured 2FA via SMS and the code is taking too long to arrive, there is probably a problem with your mobile network provider. Choose to enable 2FA thourgh an app.

Enabling 2FA through an app

To use the key generated by the authentication app, follow the steps below:

  1. Download the Google Authenticator app (App Store / Google Play).
    {"base64":"  ","img":{"width":448,"height":558,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":36683,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Authentication/Two-factor%20authentication/enabling-2-factor-authentication-login_2.png"}}
  2. Use the app to scan the QR Code with your mobile camera. Your VTEX account will be added to the app with a 6-digit code.
    {"base64":"  ","img":{"width":3401,"height":4704,"type":"jpg","mime":"image/jpeg","wUnits":"px","hUnits":"px","length":713740,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Authentication/Two-factor%20authentication/enabling-2-factor-authentication-login_3.jpg"}}
  3. Enter the 6-digit code displayed to complete your login. The app code is updated periodically, so check it whenever you need the access code.

{"base64":"  ","img":{"width":448,"height":512,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":26189,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Authentication/Two-factor%20authentication/enabling-2-factor-authentication-login_4.png"}}

If you log in with your email and password on the same computer, the access key will be requested ** every three days**. When this happens, check the code in the app.

Enabling 2FA through SMS

To use a key sent through SMS, follow the steps below:

  1. Enter your phone number to receive the code through SMS. Enter the country and area code.

{"base64":"  ","img":{"width":448,"height":494,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":24482,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Authentication/Two-factor%20authentication/enabling-2-factor-authentication-login_5.png"}}

  1. You will receive a text message from VTEX on the provided phone. Enter the 6-digit key to complete your login.

    {"base64":"  ","img":{"width":448,"height":526,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":24813,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Authentication/Two-factor%20authentication/enabling-2-factor-authentication-login_6.png"}}

We can’t guarantee that your network operator will be able to deliver the access key whenever necessary. If the text message doesn't arrive, try resending the code or enable 2FA through the app.

Changing the 2FA configuration

To change the two-factor verification settings, follow the steps below:

  1. Access your user settings by clicking your profile avatar indicated by the first letter of your email on the top-right corner of the Admin, and then click User settings.

  2. Click Two-Factor Authentication to see the settings.

  3. You can change the settings by following similar steps to the ones described in the Enabling 2FA through SMS and Enabling 2FA through an app sections.

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
GithubDeveloper portalCommunityFeedback