> For the complete documentation index, see [llms.txt](https://docs.portainer.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.portainer.io/admin/user/teams/add.md).

# Add a new team

From the menu expand **User-related** then select **Teams**.

<figure><img src="/files/K4ils88fRH7VLl0RGCTL" alt=""><figcaption></figcaption></figure>

Enter the name of the team and optionally select team leaders. Team leaders can add and remove existing users to and from their team, as well as promote existing team members to co-team leaders.

{% hint style="warning" %}
If your Portainer installation uses external authentication and teams are synced from your external authentication provider, the team leader role is disabled.
{% endhint %}

<figure><img src="/files/4yseNoxMhw0EmjmIALAL" alt=""><figcaption></figcaption></figure>

If you have any add-ons installed you will see additional options when creating teams:

| Field/Option             | Overview                                                                                                                                                                              |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Restrict to add-ons only | When this is toggled on, members of this team can only use the add-ons they've been granted. They won't see the Portainer management UI, and will land on an add-on when they log in. |
| Grant access to add-ons  | Select the add-on or add-ons that this team can access.                                                                                                                               |

{% hint style="info" %}
These options can also be set and changed on teams after creation.
{% endhint %}

<figure><img src="/files/89YAvHTHMTXSsiNZ9pIn" alt=""><figcaption></figcaption></figure>

When you're ready, click **Create team**.