# Teams

Teams **categorise users in groups**, using their Unity ID (i.e. their email).

If a user is signed in and their email is listed as a user of a Hats Team, they are *part of that* Team. This happens as soon as the Editor is launched. Users can then jump to other Teams if they so wish.

{% hint style="success" %}
**Build on Hats**

In addition to using Teams to put users into workspaces, you can also [build tools](https://tools.continis.io/hats/building-on-hats/building-hats-based-tools) that modify their appearance or behaviour depending on the active Team.
{% endhint %}

## Managing Teams

<figure><img src="https://3932909560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJbMi1RQ5OkWEfZdkCUEX%2Fuploads%2FFI2WT6C9ohVZjSCjIvAR%2FActiveTeam.png?alt=media&#x26;token=2aa01343-2eb5-4444-82c2-f08dcc394765" alt=""><figcaption><p>The Teams section in Project Settings > Hats</p></figcaption></figure>

By going to **Project Settings > Hats** and scrolling down, you can see the Teams section of Hats. Here you can see which Team you're currently part of.

By default, new users are in "No Team", meaning the Editor is not affected by Teams. After you have created Teams you can join a different one, or even return to No Team.

## The Team Catalog

In Hats, available Teams are contained in a catalog ScriptableObject.

This asset is created automatically in :open\_file\_folder: `Assets/Settings/Hats` the first time the project is loaded. After this, you can add Teams to the catalog by simply selecting the SO and adding to its Teams list:

<figure><img src="https://3932909560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJbMi1RQ5OkWEfZdkCUEX%2Fuploads%2F0HPg7duzjRBFlU2jKpBK%2FTeamsCatalog.png?alt=media&#x26;token=d8f1c58f-924e-48c2-a305-b6c7657da2f5" alt="" width="563"><figcaption><p>The TeamsCatalog Inspector, with 4 Teams in it</p></figcaption></figure>

Individual Teams are sub-assets of the Catalog, and they are automatically managed for you.

<figure><img src="https://3932909560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJbMi1RQ5OkWEfZdkCUEX%2Fuploads%2FD7mm5JREXIxObwGtRTm3%2FTeamCatalogSubassets.png?alt=media&#x26;token=981782f2-3fad-4681-b341-74fddaa8d4ee" alt="" width="221"><figcaption><p>The Teams as sub-assets of the Catalog</p></figcaption></figure>

{% hint style="info" %}
The Teams Catalog is meant to be shared and under version control, as you want everyone working on the project to have the same Teams.
{% endhint %}

## Setup a Team

<figure><img src="https://3932909560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJbMi1RQ5OkWEfZdkCUEX%2Fuploads%2FmqlCnR3FZoy56ebwtYOV%2FTeamInspector.png?alt=media&#x26;token=e6231b3d-b435-4458-85b4-d2e2d8d49e5b" alt="" width="563"><figcaption><p>The Inspector of a Team asset</p></figcaption></figure>

As you add Teams to the Catalog, you can change their properties

### Team Workspace

Each Team can have a workspace associated with it. This workspace is applied as soon as the editor starts, and cannot be switched unless one where to switch Teams.

Differently from personal workspaces, Team workspaces are enabled by default for all users who are part of the team. You can think of Team workspaces as an underlying layer: first the Team workspace is applied, then any active personal workspace is applied on top.

### Members

Members of a team are emails (Unity ID emails) that are associated to the team. If a user is logged in as that Unity ID upon launching the editor, the team becomes *their* team and its workspace (if present) is enabled.

Member emails can be tweaked manually, or you can add yours to a team by [switching to it](https://tools.continis.io/hats/teams/switching-teams).