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.
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.
Create your custom role(s)
Define permissions and select allowed add-ons and child sites for the role(s)
Create new users (optional)
Assign the role to dashboard site users
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
To create a custom role,
Log in to your MainWP Dashboard
Go to the MainWP > Add-ons > Agency > Team Control page
Go to the Roles & Permissions tab
Click the Create New Role button in the action bar
Enter the role name and description
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.
Click the Create Role button
Define Role Permissions
Log in to your MainWP Dashboard
Go to the MainWP > Add-ons > Agency > Team Control page
Go to the Roles & Permissions tab
Locate the previously created role
Click the Edit Role / Manage Permissions button
Set MainWP Dashboard permissions
Set Allowed Child Sites
Use Select by Site or Select by Tag to choose the child sites this role can access.
Click the Update Role button
Assign Role to a User
Log in to your MainWP Dashboard
Go to the MainWP > Add-ons > Agency > Team Control page
Go to the Dashboard Users tab
The users table loads automatically when you open the tab.
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.
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.
Choose Change role from the Bulk actions menu
Select the new role, then click Apply.
Edit Custom Role
Log in to your MainWP Dashboard
Go to the MainWP > Add-ons > Agency > Team Control page
Go to the Roles & Permissions tab
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.
Click the Edit Role / Manage Permissions button
Set MainWP Dashboard permissions
Set Allowed Child Sites
Use Select by Site or Select by Tag to choose the child sites this role can access.
Click the Update Role button
Delete Custom Role
Log in to your MainWP Dashboard
Go to the MainWP > Add-ons > Agency > Team Control page
Go to the Roles & Permissions tab
Locate the role you want to delete
Click the Delete Role button
Reassign affected users if prompted
If any users currently have that role, choose a replacement role for each user in the confirmation dialog.
Click the Delete Role button in the confirmation dialog
