# Managing Teams (/teams/managing-teams)



A team is the top of the tree. It holds projects and the settings they share, and it has its own [members](/teams/members-and-permissions). Every team runs in its own namespace on the cluster, so nothing in one team can see another.

Your instance starts with one team, `Default`.

## Create a team [#create-a-team]

Only people who own the instance can create teams. Open the team switcher in the breadcrumb at the top of the page and press **New Team**. Give it a name of up to 32 characters, unique on the instance, and an optional description.

Whoever creates the team is its first admin. From there, add people under **Settings** > **Members**.

A new team starts empty. Create a project in it to get going. See [Projects and Environments](/teams/projects-and-environments).

## Settings [#settings]

**Team** > **Settings** has:

* **General**: the team's name, description and icon.
* **Variables**: values shared by every project in the team. See [Variables](/services/variables#team-and-project-variables).
* **Storage**: buckets for database backups. See [S3 Storage](/teams/s3-storage).
* **Members**: who can reach the team and with what role.
* **Webhooks**: notifications about the team's projects and services. See [Webhooks](/monitoring/webhooks).
* **GitHub Apps**: GitHub connections shared with the team.
* **Danger Zone**: delete the team.

## Team icon [#team-icon]

A team shows its icon next to its name in the team switcher. Until you set one, the icon is the first letter of the team's name in a circle.

To set one, go to **Settings** > **General** and click the avatar, or drop a file on it. It can be an SVG, PNG or JPEG of up to 512 KB and 1024×1024 pixels. The icon is cropped to a circle, so a square image works best. **Remove** goes back to the letter.

Changing the icon needs the editor role on the team. SVGs need a `viewBox` and can't have scripts or links to other files. PNG and JPEG files are stored without their metadata, such as camera or location details.

## Delete a team [#delete-a-team]

<Callout type="warn" title="Deleting takes everything with it">
  Deleting a team permanently deletes every project in it, with their services, databases, volumes
  and buckets, and the namespace they ran in. It cannot be undone.
</Callout>

Deleting needs the admin role on the team. Go to **Settings** > **Danger Zone**, press **Delete Team** and type the team's name to confirm.

Members keep their accounts and whatever they have on other teams. A link to the deleted team takes them to another of their teams, or shows **Team not found** if they have none. API keys and connected apps limited to the deleted team stop reaching anything.
