Menu
Feedback
Start here
Tutorials
Developer portal

Known Issues
Support Rules
Troubleshooting

Frequently Asked Questions
Announcements
Tutorials
Tutorials
Explore in-depth tutorials for operating your VTEX store.
Tutorials
Account management
Users
How to manage users
How to manage users

The user management with access to the administrative environment of your VTEX store is done through the Account settings, in the Users page. To access the page, click on your profile avatar on the VTEX Admin top bar, marked by the initial of your email, and click on Account settings > Users .

This page displays the list of users with their Name, Email and MFA configuration. There are also options to search for users, export users and create new ones. Other options available on this interface are to edit or delete each user.

{"base64":"  ","img":{"width":901,"height":198,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":20816,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Account%20management/Users/managing-users_1.png"}}

Any user that wants to manage users or application keys must have a profile with the Save User resource. You can use the default profile User Administrator - RESTRICTED, for example.

Creating a new user

  1. Click on your profile avatar on the VTEX Admin top bar, marked by the initial of your email, and click on Account settings > Users .
  2. Click on the + New button.
  3. Fill in the Email.
    {"base64":"  ","img":{"width":966,"height":692,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":17665,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Account%20management/Users/managing-users_2.png"}}
  4. Click on + Add roles.
  5. Add the desired Roles.
    {"base64":"  ","img":{"width":1042,"height":712,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":41687,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Account%20management/Users/managing-users_3.PNG"}}
  6. Click on Add roles to confirm the selection.
  7. Click on Save.

The user will receive an email confirming the information was received, with a link to register the password.

The password must have at least eight characters and a number, a capital letter and a lowercase letter. After filling them in, an access key will be sent by email to confirm the account.

Editing users

  1. Click on your profile avatar on the VTEX Admin top bar, marked by the initial of your email, and click on Account settings > Users .
  2. To edit an existing user, click on their name in the list of users. Another possibility is to click on the menu button next to the desired user and then on Edit.
    {"base64":"  ","img":{"width":908,"height":239,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":31767,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Account%20management/Users/managing-users_4.png"}}

    It is not possible to change the email of an existing user. In this case, it is necessary to delete the user and create them again with the new email.

  3. In the editing page you can add and remove the Roles of the user, as shown in the image below.
    {"base64":"  ","img":{"width":1042,"height":712,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":41687,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Account%20management/Users/managing-users_5.PNG"}}
  4. Click on Add roles to confirm the selection.
  5. Click on Save.

An alert will appear when adding roles to a user who does not use multiple factor authentication (MFA). The article Enable login by 2-factor authentication shows how to enable this setting.

If all roles are removed from the user, they will no longer be able to access VTEX Admin.

Deleting a user

  1. Click on your profile avatar on the VTEX Admin top bar, marked by the initial of your email, and click on Account settings > Users .
  2. Click on the menu button next to the user you want to remove.
  3. Click on the Delete option.
    {"base64":"  ","img":{"width":901,"height":235,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":27370,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Account%20management/Users/managing-users_6.png"}}
    A message will appear to confirm the removal of the user.
  4. To confirm, click on the button YES, REVOKE ALL ACCESS.
    {"base64":"  ","img":{"width":731,"height":211,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":16524,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Account%20management/Users/managing-users_7.png"}}

Exporting user data

  1. Click on your profile avatar on the VTEX Admin top bar, marked by the initial of your email, and click on Account settings > Users .
  2. To export user data, click Export.
  3. Save the CSV file to your device. The file includes the ID, email and name of each user.
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