User management for your VTEX store’s administrative environment is done under Account management on the Users page. To access the page, click your profile avatar on the VTEX Admin top bar (the circle with the initial of your email) and click Account settings > Users.

This page allows you to:

• Create a user
• Edit a user
• Delete a user
• Export users

The table on the page shows:

The search bar lets you search by users’ email addresses and displays results in real time.

To manage admin users, you need to have a role with the following License Manager resources:

To add someone to the VTEX Admin, register their email and assign the appropriate roles. Follow the steps below to complete the process:

1. In the VTEX Admin top bar, click your profile avatar (the circle with your email initial), then go to Account settings > Users.
2. Click the + New button.
3. Complete the Email field.
4. Select the desired Roles.
5. Click Save.

The user will receive an email confirming the information was received, with a link to set the password. The password must be at least eight characters and include a number, an uppercase letter, and a lowercase letter. After the password is set, an access key will be sent by email to confirm the account.

If you need to adjust access permissions or update the roles of an existing user, edit the user as follows.

Apply the principle of least privilege: assign each user only the roles and resources that are strictly necessary for their daily activities. This minimizes security risks and helps maintain tighter control over the environment.

1. In the VTEX Admin top bar, click your profile avatar (the circle with your email initial), then go to Account settings > Users.
2. To edit an existing user, click the ⋮ menu button on the user’s row and select Edit. You can’t change the email of a registered user. If needed, delete the existing record and create a new one.
3. On the edit screen, you can add or remove the user roles.
4. After making the desired changes, click Save.

An alert will be displayed when adding roles to a user who doesn’t use multi-factor authentication (MFA). The article Enable login by 2-factor authentication shows how to enable this setting.

If you remove all roles from a user, they will no longer have access to the VTEX Admin.

When a team member should no longer access the VTEX Admin, you must remove their user account. Follow the steps below to complete this removal safely.

1. In the VTEX Admin top bar, click your profile avatar (the circle with your email initial), then go to Account settings > Users.

2. Click the menu button next to the user you want to remove.

3. Click Delete.

   A message will appear to confirm the removal of the user.

4. To confirm, click Yes, revoke all access.

To view or save a list of all admin users, you can export the data as a CSV file. See below how to generate this report:

1. In the VTEX Admin top bar, click your profile avatar (the circle with your email initial), then go to Account settings > Users.
2. To export user data, click Export.

The CSV download starts automatically. The file includes each user’s ID, email, roles, and MFA configuration.

• Account settings overview
• Roles
• License Manager resources
• Enable login by 2-factor authentication