Menu
Feedback
Start here
Tutorials
Developer portal

Known Issues
Support Rules
Troubleshooting

Frequently Asked Questions
Announcements
Start here
VTEX Modules: Getting Started
Accounts & Permissions
Enabling two-factor authentication (2FA)

With two-step verification (also known as two-factor authentication or 2FA), you add an extra layer of security to your account to protect it if your password is revealed to a third party.

After enabling the 2FA, you will make your store login using:

  • Your password (something you know)
  • Your phone number (something you own)

Your phone will generate a short key at the moment of login. Thus, it becomes almost impossible that someone unauthorized accesses your store using your information.

How to enable the 2FA

We always request the two-step verification setup, in case it is not enabled when users log in using their email and password.

There are two authentication options:

  • App Google (key generated by an authentication app)
  • SMS Message (key sent by text message)

{"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/tracks/contas-e-permissoes/enabling-2-factor-authentication-login_1.png"}}

We recommend you to use aauthentication application to prevent failures in your telephone provider from making your login impossible. Though the app, the access key will always be available for use.

As some companies restrict the use of cell phones by telesales operators, users with the telesales role do not have to enable the 2FA when logging in with email and password.

Enabling the 2FA through an app

To use a key generated by authentication application:

  1. Download the application Google Authenticator (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/tracks/contas-e-permissoes/enabling-2-factor-authentication-login_2.png"}}

  1. Use the application to read the QR Code with your phone's camera.

{"base64":"  ","img":{"width":448,"height":618,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":43029,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tracks/contas-e-permissoes/enabling-2-factor-authentication-login_3.png"}}

  1. Your VTEX account will be added to the application, with a 6-digit code. Enter the code to finish your login.

The app code is regularly updated. It will not be necessary to memorize it, go to the application whenever you need it.

{"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/tracks/contas-e-permissoes/enabling-2-factor-authentication-login_4.png"}}

If you log in using your email and password on the same computer, you will be asked for your access key every 3 days. When this happens, check the code in the application..

Enabling 2FA via SMS

To use a key sent by text message:

  1. enter your phone number to receive the code by SMS - don't forget to enter your 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/tracks/contas-e-permissoes/enabling-2-factor-authentication-login_5.png"}}

  1. You will receive a text message from VTEX on the indicated phone. Enter the 6-digit key to finish 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/tracks/contas-e-permissoes/enabling-2-factor-authentication-login_6.png"}}

We cannot guarantee that your telephone company will be able to deliver the access key whenever necessary. If the VTEX text message does not arrive, try resending the code or enable the 2FA per-application.

Change 2FA settings

To change the two-step verification settings:

  1. Access your user settings by clicking on the circle with your initials in the top-right corner of the Admin.

{"base64":"  ","img":{"width":270,"height":224,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":14550,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tracks/contas-e-permissoes/enabling-2-factor-authentication-login_7.png"}}

  1. Click 2-step verification to see your settings.

{"base64":"  ","img":{"width":906,"height":292,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":17270,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tracks/contas-e-permissoes/enabling-2-factor-authentication-login_8.png"}}

  1. You can then change your settings by following similar steps as those described in the sections above to enable 2FA via SMS and application.
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