Skip to main content

​
What You’ll Learn

  • Creating custom roles for team members
  • Defining permissions and allowed sites
  • Assigning roles to users
  • Managing role-based access control
Extension Add-on - This add-on provides standalone functionality within MainWP Dashboard. No third-party plugins required.
MainWP Team Control Add-on allows you to create custom roles for users on your Dashboard site. With the custom roles you create, you can limit access to specific MainWP Dashboard features, add-ons, and child sites. To create your MainWP Management team, you need to:
1

Create your custom role(s)

2

Define permissions and select allowed add-ons and child sites for the role(s)

3

Create new users (optional)

4

Assign the role to dashboard site users

​
What’s New in 5.2.0

  • You can use Team Control abilities to manage roles, members, permissions, and role notes.
  • You can grant protected authority and operation permissions only through authorized roles.
  • You preview and confirm role changes before they apply. If an operation is interrupted, the extension can recover without leaving a partial role change.
  • Existing installations receive an owner automatically, and you cannot grant yourself protected access.
  • When you remove a user, the extension verifies the multisite deletion result before changing role membership.
  • Repeating a role-note request does not create duplicates, and a complete role update replaces your prior permission set.
Team Control Dashboard Users tab showing role filters and the users table Users without permission won’t be able to use unselected actions or access certain MainWP Dashboard pages. Team Control extension allows you to create custom roles only on your MainWP Dashboard site. Roles created with the MainWP Team Control extension have effect only inside the MainWP Dashboard plugin. If you need to limit access to certain WordPress admin sections, you will need to use a third-party plugin. Any role created by the extension is equivalent to the Administrator role outside of the MainWP Dashboard plugin. The Team Control screen has two tabs:
  • Dashboard Users - View users immediately, filter by one or more roles, search the users table, and apply bulk actions.
  • Roles & Permissions - Create roles, review role descriptions, see how many users have each role, and manage or delete roles.

​
Create a Custom Role

Team Control Create Role modal showing role info and permission sections To create a custom role,
1

Log in to your MainWP Dashboard

2

Go to the MainWP > Add-ons > Agency > Team Control page

3

Go to the Roles & Permissions tab

4

Click the Create New Role button in the action bar

5

Enter the role name and description

6

Configure the role permissions in the same modal

The Create Role / Manage Permissions modal includes the role information fields and permission sections together, so you can define the role before saving it.
7

Click the Create Role button

After the role is created, it appears in the Roles & Permissions table.

​
Define Role Permissions

1

Log in to your MainWP Dashboard

2

Go to the MainWP > Add-ons > Agency > Team Control page

3

Go to the Roles & Permissions tab

4

Locate the previously created role

5

Click the Edit Role / Manage Permissions button

6

Set MainWP Dashboard permissions

7

Set Allowed Add-ons

8

Set Allowed Child Sites

Use Select by Site or Select by Tag to choose the child sites this role can access.
9

Click the Update Role button

After setting custom permissions, you are ready to assign this role to an existing user or to create a new user with this role. By selecting permissions, add-ons, and child sites, you are allowing users with this role to use those actions only on the allowed sites. If you grant access through Select by Tag, the role can access the child sites that belong to those selected tags.

​
Assign Role to a User

Team Control bulk action menu showing the Change role action and role selector
1

Log in to your MainWP Dashboard

2

Go to the MainWP > Add-ons > Agency > Team Control page

3

Go to the Dashboard Users tab

The users table loads automatically when you open the tab.
4

Filter or search for the user

Use the role filter in the action bar and click Filter Users, or use the table search field to narrow the visible users.
5

Select the user

Use the checkbox next to the user. You can select multiple users when you need to assign the same role to more than one account.
6

Choose Change role from the Bulk actions menu

Select the new role, then click Apply.
Note: If you’d like a user to have access through a site tag, grant the role access to that tag in Allowed Child Sites > Select by Tag.

​
Edit Custom Role

1

Log in to your MainWP Dashboard

2

Go to the MainWP > Add-ons > Agency > Team Control page

3

Go to the Roles & Permissions tab

4

Locate the role you want to edit

Use the table search, sorting, pagination, or the Users count column to review the available roles. The Users count links to the Dashboard Users tab filtered by that role.
5

Click the Edit Role / Manage Permissions button

6

Set MainWP Dashboard permissions

7

Set Allowed Add-ons

8

Set Allowed Child Sites

Use Select by Site or Select by Tag to choose the child sites this role can access.
9

Click the Update Role button

By selecting permissions, add-ons, and child sites, you are allowing users with this role to use those actions only on the allowed sites.

​
Delete Custom Role

1

Log in to your MainWP Dashboard

2

Go to the MainWP > Add-ons > Agency > Team Control page

3

Go to the Roles & Permissions tab

4

Locate the role you want to delete

5

Click the Delete Role button

6

Reassign affected users if prompted

If any users currently have that role, choose a replacement role for each user in the confirmation dialog.
7

Click the Delete Role button in the confirmation dialog