> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mainwp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage Users

> Manage WordPress users across your Child Sites from the MainWP Dashboard. Create new users, edit existing users, change roles, import users via CSV, and delete users remotely.

The Manage Users feature lets you control WordPress user accounts across all your child sites from a central location. Create new users on multiple sites at once, edit existing user details, import users via CSV, and remove user accounts without logging into each site individually.

## What You'll Accomplish

* Search and view users across all child sites
* Create new user accounts on one or multiple sites
* Import multiple users via CSV file
* Edit existing user accounts
* Delete single or multiple users

## Prerequisites

* MainWP Dashboard installed and activated
* At least one child site connected to your Dashboard
* Administrator access to your Dashboard site

***

[Manage WordPress Users and Passwords with MainWP](https://www.youtube.com/embed/vfZFneUTtJw)

***

## View Existing Users

**1. Navigate to Manage Users**

Go to **MainWP > Users > Manage Users**.

![Go to the MainWP > Users > Manage Users page](https://mintcdn.com/mainwp/HAFny0Nanby6rgrO/images/dashboard/sites-users-27ef2c.png?fit=max\&auto=format\&n=HAFny0Nanby6rgrO\&q=85\&s=17ae8d9be20ea7384c81db472217095d)

**2. Set search preferences**

In the Search section, configure your filter criteria (role, username, email, etc.).

**3. Select child sites**

[Select the child sites](https://docs.mainwp.com/getting-started/mainwp-user-interface.md) you want to search.

**4. Execute search**

Click **Show Users**.

A list of matching users appears at the bottom of the page.

***

## Create a New User

Create a WordPress user on one or multiple child sites simultaneously.

**1. Navigate to Add New**

Go to **MainWP > Users > Add New**.

![Go to the MainWP > Users > Add New page](https://mintcdn.com/mainwp/HAFny0Nanby6rgrO/images/dashboard/sites-users-a2d483.png?fit=max\&auto=format\&n=HAFny0Nanby6rgrO\&q=85\&s=1494ef38ad412318861c6d74d012f745)

**2. Enter user details**

Complete the user information:

| Field | Description |
| - | - |
| Username | Login name for the user |
| Email Address | User's email for notifications and password resets |
| First Name | User's first name (optional) |
| Last Name | User's last name (optional) |
| Website URL | User's website (optional) |
| Password | Enter custom password or use auto-generated one |
| Send Password | Check to email the password to the user |
| Role | Select the user's WordPress role |

**3. Select sites**

[Select the child sites](https://docs.mainwp.com/getting-started/mainwp-user-interface.md) where you want to create this user.

**4. Create user**

Click **Add New User**.

MainWP creates the user account on all selected sites.

***

## Import Users via CSV

Import multiple users at once using a CSV file.

**1. Navigate to Import Users**

Go to **MainWP > Users > Import Users**.

**2. Download sample**

Click **Download Sample CSV file** to get the template.

**3. Edit CSV file**

Open the downloaded file in a text editor. Replace the demo values (lines 2-6) with your user data.

![Import Users - Sample CSV](https://mintcdn.com/mainwp/HAFny0Nanby6rgrO/images/dashboard/sites-users-8236fd.jpg?fit=max\&auto=format\&n=HAFny0Nanby6rgrO\&q=85\&s=85fd72a4e7bdeef9365b737a73d143f2)

**4. Format entries**

Enter values in this order, separated by commas:

| Position | Field | Notes |
| - | - | - |
| 1 | Username | Required |
| 2 | Email Address | Required |
| 3 | First Name | Optional |
| 4 | Last Name | Optional |
| 5 | Website URL | Optional |
| 6 | Password | Password for the new user |
| 7 | Send Password | 0 = don't email, 1 = send the user notification |
| 8 | Role | WordPress role, such as `subscriber` or `editor` |
| 9 | Select Sites | Child Site URLs, separated by semicolons |
| 10 | Select Groups | Site tag names, separated by semicolons |

Keep all ten columns, including empty optional fields. Enclose any field containing a comma in double quotes. To include a double quote inside a quoted field, double it (`""`). Backslashes are treated literally.

**5. Upload and import**

Upload the CSV file to your Dashboard. Check **CSV file contains a header** if you kept line 1 from the sample. Click **Import Users**.

> [!WARNING]
>
> MainWP requires CSV format. TXT and other text formats will not work.

### Retry Failed Rows

If any rows fail, click **Save failed** in the import results. Correct the failed rows and reimport the CSV.

Imported passwords are excluded from the import log and the failed-row CSV. Fill in the Password column for each failed row before retrying.

***

## Edit Existing Users

**1. Search for user**

Go to **MainWP > Users > Manage Users** and search for the user.

**2. Open edit form**

In the search results, locate the user and click **Edit** in the Actions column.

![User search results table showing matching users](https://mintcdn.com/mainwp/HAFny0Nanby6rgrO/images/dashboard/sites-users-a4612a.png?fit=max\&auto=format\&n=HAFny0Nanby6rgrO\&q=85\&s=65286567afc87db31c65cfe2c472f0e7)

**3. Update details**

Modify the user information and save changes.

***

To change the password for the connected administrator account on selected Child Sites, go to [Admin Passwords](https://docs.mainwp.com/sites/users/admin-passwords.md).

***

## Delete Users

### Delete a Single User

**1. Search for user**

Go to **MainWP > Users > Manage Users** and search for the user.

**2. Delete**

In the search results, locate the user and click **Delete** in the Actions column.

![User search results with users selected for deletion](https://mintcdn.com/mainwp/HAFny0Nanby6rgrO/images/dashboard/sites-users-5b800a.png?fit=max\&auto=format\&n=HAFny0Nanby6rgrO\&q=85\&s=036818f66b3c691c531fc05c2ece2e25)

### Bulk Delete Users

**1. Search for users**

Go to **MainWP > Users > Manage Users** and search for the users you want to delete.

**2. Select users**

Check the checkbox next to each user you want to delete.

**3. Apply bulk action**

Select **Delete** from the **Bulk Actions** dropdown and click **Apply**.

***

## Important Limitations

### Cannot Delete Connection User

MainWP prevents deleting the administrator account used to establish the connection with a child site. To delete this user:

1. Go to **MainWP > Sites > Manage Sites**
2. Edit the child site settings
3. Change the connected administrator to a different user
4. Delete the original user

### Content Attribution

When you delete a user who authored posts or pages, their content is automatically attributed to the connection administrator. To change authorship to a different user, bulk-edit the content directly in the child site's WP Admin.

***

## Self-Check Checklist

* [ ] You can search and view users across child sites
* [ ] New users are created successfully on selected sites
* [ ] CSV imports complete without errors
* [ ] User edits save correctly
* [ ] User deletions complete as expected

***

## Related Resources

* [Manage Sites](https://docs.mainwp.com/sites/management/manage-child-sites.md) - Connect and manage child sites
* [Admin Passwords](https://docs.mainwp.com/sites/users/admin-passwords.md) - Change the connected administrator account password on selected Child Sites
* [MainWP User Interface](https://docs.mainwp.com/getting-started/mainwp-user-interface.md) - Learn site selection controls


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.