> ## 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.

# Team Control

> The Team Control Extension allows you to create your team and arrange the WordPress management tasks among your team members. With a few clicks you can create your custom roles and set custom privileges to created roles.

## What You'll Learn

* Creating custom roles for team members
* Defining permissions and allowed sites
* Assigning roles to users
* Managing role-based access control

***

<div id="addon-data" style={{display: 'none'}} data-title="Team Control" data-purchase-url="https://mainwp.com/extension/team-control/" data-pricing-tier="pro" data-bundle="MainWP Pro" data-addon-type="extension" data-version="5.1" data-developer="MainWP" data-changelog-url="https://mainwp.com/changelog/mainwp-team-control-extension/" data-owned-by="Jestart LLC" data-privacy-url="https://mainwp.com/mainwp-plugin-privacy-policy/" />

<Info>
  **Extension Add-on** - This add-on provides standalone functionality within MainWP Dashboard. No third-party plugins required.
</Info>

[MainWP Team Control Add-on](https://mainwp.com/add-on/team-control/) 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:

<Steps>
  <Step title="Create your custom role(s)" />

  <Step title="Define permissions and select allowed add-ons and child sites for the role(s)" />

  <Step title="Create new users (optional)" />

  <Step title="Assign the role to dashboard site users" />
</Steps>

<img src="https://mintcdn.com/mainwp/uy0yOtYL-tUV6JoS/images/add-ons/team-control-dashboard-users.png?fit=max&auto=format&n=uy0yOtYL-tUV6JoS&q=85&s=a768c0301b84353a0805ce437c8159c3" alt="Team Control Dashboard Users tab showing role filters and the users table" width="1600" height="670" data-path="images/add-ons/team-control-dashboard-users.png" />

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

<img src="https://mintcdn.com/mainwp/uy0yOtYL-tUV6JoS/images/add-ons/team-control-create-role-modal.png?fit=max&auto=format&n=uy0yOtYL-tUV6JoS&q=85&s=cb5644ccf596a6b30eff1a307c1cac49" alt="Team Control Create Role modal showing role info and permission sections" width="1600" height="1189" data-path="images/add-ons/team-control-create-role-modal.png" />

To create a custom role,

<Steps>
  <Step title="Log in to your MainWP Dashboard" />

  <Step title="Go to the MainWP > Add-ons > Agency > Team Control page" />

  <Step title="Go to the Roles & Permissions tab" />

  <Step title="Click the Create New Role button in the action bar" />

  <Step title="Enter the role name and description" />

  <Step title="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.
  </Step>

  <Step title="Click the Create Role button" />
</Steps>

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

## Define Role Permissions

<Steps>
  <Step title="Log in to your MainWP Dashboard" />

  <Step title="Go to the MainWP > Add-ons > Agency > Team Control page" />

  <Step title="Go to the Roles & Permissions tab" />

  <Step title="Locate the previously created role" />

  <Step title="Click the Edit Role / Manage Permissions button" />

  <Step title="Set MainWP Dashboard permissions" />

  <Step title="Set Allowed Add-ons" />

  <Step title="Set Allowed Child Sites">
    Use **Select by Site** or **Select by Tag** to choose the child sites this role can access.
  </Step>

  <Step title="Click the Update Role button" />
</Steps>

After setting custom permissions, you are ready to assign this role to an existing user or to [create a new user](https://wordpress.org/documentation/article/users-add-new-screen/) 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

<img src="https://mintcdn.com/mainwp/uy0yOtYL-tUV6JoS/images/add-ons/team-control-change-role-bulk-action.png?fit=max&auto=format&n=uy0yOtYL-tUV6JoS&q=85&s=d66cb8c4fb0d598828ee45a0e292fac8" alt="Team Control bulk action menu showing the Change role action and role selector" width="1600" height="658" data-path="images/add-ons/team-control-change-role-bulk-action.png" />

<Steps>
  <Step title="Log in to your MainWP Dashboard" />

  <Step title="Go to the MainWP > Add-ons > Agency > Team Control page" />

  <Step title="Go to the Dashboard Users tab">
    The users table loads automatically when you open the tab.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Choose Change role from the Bulk actions menu">
    Select the new role, then click **Apply**.
  </Step>
</Steps>

**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

<Steps>
  <Step title="Log in to your MainWP Dashboard" />

  <Step title="Go to the MainWP > Add-ons > Agency > Team Control page" />

  <Step title="Go to the Roles & Permissions tab" />

  <Step title="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.
  </Step>

  <Step title="Click the Edit Role / Manage Permissions button" />

  <Step title="Set MainWP Dashboard permissions" />

  <Step title="Set Allowed Add-ons" />

  <Step title="Set Allowed Child Sites">
    Use **Select by Site** or **Select by Tag** to choose the child sites this role can access.
  </Step>

  <Step title="Click the Update Role button" />
</Steps>

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

<Steps>
  <Step title="Log in to your MainWP Dashboard" />

  <Step title="Go to the MainWP > Add-ons > Agency > Team Control page" />

  <Step title="Go to the Roles & Permissions tab" />

  <Step title="Locate the role you want to delete" />

  <Step title="Click the Delete Role button" />

  <Step title="Reassign affected users if prompted">
    If any users currently have that role, choose a replacement role for each user in the confirmation dialog.
  </Step>

  <Step title="Click the Delete Role button in the confirmation dialog" />
</Steps>

***

## Related Resources

* [White Label Extension](/add-ons/agency/white-label-extension) - Rebrand MainWP for clients
* [Agency Add-ons](/add-ons/agency) - Browse agency add-ons
