The Most Popular Extension Builder for Magento 2

With a big catalog of 224+ extensions for your online store

Create New Magento 2 Admin User [Step-by-step guide]

From Magento 2 configuration, you can create admin user accounts as many as you need but they will be set in different access levels if you ask. For example, you can assign the view and change only for websites or stores without any global settings or data. Online merchants need to restrict the admin access to ensure the management tasks are not overlapped. Moreover, it also enhances a website’s security if the store owner wants to protect particular data.

To limit the access permissions for admin user accounts, you can complete the required credentials on the Magento Administrator, which will be described in detail in the tutorial I am writing here.

Table of Contents

Steps to Create New Admin User in Magento 2

Step 1: Configure User Information

First, you have to add the user’s information such as name, email, password, and other details.

  • On the Admin panel, click System. In the Permissions section, select All Users.

Alt text

  • In the upper-right corner, click Add New User button

Alt text .

  • In the Account Information section, do the following:

How to Create New Admin Magento 2

  • In the User Name field, enter the user name for account. It is not case-sensitive.
  • Complete the following information:

    • First Name
    • Last Name
    • Email address: this email address must be unique.
  • In the Password and Password Confirmation field, enter the password correctly. The password should be secured, should contain more than seven characters and should include both letters and numbers.

  • In the Interface Locale field, select the language to be used for the Admin interface if your store has multiple languages.

  • In the This Account is field, set to Active

  • In the Current User Identity Verification section, enter your password in Your Password.

How to Create New Admin Magento 2

Step 2: Determine User Role

In this step, you are going to set the particular role for the Magento admin account that you have just created.

  • In the panel on the left, choose User Role. The grid lists all the existing roles. Initially, the only role available is Administrators.

How to Create New Admin Magento 2

  • In the Assigned column, select the Administrators option.
  • When complete, click Save User.

Step 3: Check Result

Flush cache and check your result.

Create Magento 2 Admin Account Via The Command Line

Another way to create an admin account / user, we can create a new admin user via command line (cli). Here is how to do it.

Go to Magento 2 root folder, run create a new admin user command line:

php bin/magento admin:user:create

It will ask you: username, password, email, first and last name.

Here is what we filled:

Admin user: mageplaza
Admin password: YourPassword
Admin email: [email protected]
Admin first name: Mageplaza
Admin last name: Team

In which you can use the following table to determine parameters and values:

Name Value Required?
--admin-firstname Administrator user’s first name. Yes
--admin-lastname Administrator user’s last name. Yes
--admin-email Administrator user’s e-mail address. Yes
--admin-user Administrator username. Yes
--admin-password Administrator user password. The password must be at least 7 characters in length and must include at least one alphabetic and at least one numeric character.

We recommend a longer, more complex password. If the password string contains special characters that require literal interpretation (such as backslashes or spaces), enclose the password in single quotations.
--magento-init-params Add to any command to customize application initialization parameters

For example: MAGE_MODE=developer&MAGE_DIRS[base][path]=/var/www/[cache][path]=/var/tmp/cache

And get result:

Created Magento administrator user named mageplaza

magento 2 create admin user

Flush cache and check your result.

The bottom line

Today we have looked at how to create a new Magento 2 admin user for your store, as well as configure the admin’s store access permissions. You can easily do this in the backend or via the command line as you wish, both in a blink of an eye. I hope this tutorial is helpful for you, so feel free to leave comments and questions for this topic down below.

Explore Admin Permissions extension!

Related Topics

Image Description
Hello, I'm the Chief Technology Officer of Mageplaza, and I am thrilled to share my story with you. My deep love and passion for technology have fueled my journey as a professional coder and an ultra-marathon runner. Over the past decade, I have accumulated extensive experience and honed my expertise in PHP development.

Looking for
Customization & Development Services?

8+ years of experiences in e-commerce & Magento has prepared us for any challenges, so that we can lead you to your success.

Get free consultant
development service

    Explore Our Products:

    People also searched for


    Stay in the know

    Get special offers on the latest news from Mageplaza.

    Earn $10 in reward now!

    Earn $10 in reward now!

    go up