# Source: https://docs.warp.dev/knowledge-and-collaboration/teams.md

# Teams

## What is a team?

A team is a group of Warp users who can collaborate on the command line together. Warp teams can share a dedicated workspace in Warp Drive. [Learn about pricing](https://www.warp.dev/pricing) and see our [Pricing FAQ](https://docs.warp.dev/support-and-community/plans-and-billing/pricing-faqs).

{% hint style="info" %}
Currently, each Warp user can only be an admin or member of one team at a time.
{% endhint %}

{% embed url="<https://www.youtube.com/watch?v=8UmreUTTrkg&start=199s&end=277s>" %}
Teams Demo
{% endembed %}

## Creating a team

You can create a new team in the following ways:

* Warp Drive, + Create a team
* `Settings > Teams`

Before you can invite team members, you will need to give your team a meaningful name. We suggest using a name to represent your organization, company, or project.

{% hint style="info" %}
You can rename the team by going to `Settings > Teams` and clicking on the team name, entering the new name, and pressing `ENTER` to accept.
{% endhint %}

<figure><img src="https://4009768362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsjNxoJ0NFCXW6rRdHH3%2Fuploads%2Fgit-blob-912c5f1cedfe6117a4f41db2b40fb97cf29907c1%2Fteam-creation-settings.png?alt=media" alt=""><figcaption></figcaption></figure>

If you create a team, you become the team’s admin and will be the only person who can delete the team. Reference [Team roles and permissions](#team-roles-and-permissions) for more info.

### Inviting new team members

Under `Settings > Teams` you can copy the invite link for your Warp team and paste it to your clipboard.

{% hint style="warning" %}
If you’re on a paid plan, upgrading will automatically include all team members in your billing. Adding new members after upgrading will also add them as paid seats.

For more details on how team member billing works, please see our [billing FAQs](https://docs.warp.dev/support-and-community/plans-and-billing/pricing-faqs#what-counts-as-a-team-member-and-how-does-billing-work-for-members).
{% endhint %}

<figure><img src="https://4009768362-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPsjNxoJ0NFCXW6rRdHH3%2Fuploads%2Fgit-blob-b8ce320cfed05ef448e4ee97e8c7be4dbc7c6214%2Fteams-invite-demo.png?alt=media" alt=""><figcaption><p>Teams settings panel</p></figcaption></figure>

When you share this link with your teammates directly (we suggest using a secure channel like Slack or email), they will be able to join your team in Warp.

## Restricting team invites by domain

Sometimes you may want to control your team so that people can only join if they also authenticate with a specific email domain, such as your company’s email domain.

Toggle on Restrict by domain to set an explicit allowlist.

If you share an invite link with somebody who’s using Warp with a domain that does not match your allowlist, they will be prompted to authenticate from an emailed link sent to a matching domain to join your team.

## Joining a team

If you have received an invite link, you can use that link to sign up or log in and join your team in Warp. If your team is using domain restriction, you will need to authenticate you have access to a specific domain before you can join your team.

## Leaving and deleting teams

If you’re a member of a team, you can visit `Settings > Teams` to leave a team at any time. Team admins (who created teams) may delete a team only after removing all team members.

## Team discoverability

Team admins can make their teams discoverable to colleagues from the same email domain. This feature is available under `Settings > Teams > Make team discoverable`.

{% hint style="info" %}
While discoverability is enabled, any new user who joins the team will add a prorated charge to the team's next month's bill. See more in our [pricing docs](https://docs.warp.dev/support-and-community/plans-and-billing/pricing-faqs#what-counts-as-a-team-member-and-how-does-billing-work-for-members).
{% endhint %}

## Transferring team admin

Team admins can transfer their role to another team member by going to `Settings > Teams > Transfer admin` and selecting the member to whom you'd like to transfer the admin role.

## Team roles and permissions

{% hint style="warning" %}
If you're a Team admin, and you choose to [delete your Warp](https://docs.warp.dev/support-and-community/privacy-and-security/privacy#manage-your-data) account, the deletion flow will require that you assign a team member as the new admin.
{% endhint %}

|                                                                                                   | Admin                                                            | Member                                 |
| ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | -------------------------------------- |
|                                                                                                   | This is the Warp user who created a team. There can only be one. | All team members who belong to a team. |
| Create a team                                                                                     | ✓                                                                |                                        |
| Restrict by domain                                                                                | ✓                                                                |                                        |
| Invite members                                                                                    | ✓                                                                | ✓                                      |
| Remove team members                                                                               | ✓                                                                |                                        |
| Leave a team                                                                                      |                                                                  | ✓                                      |
| Delete a team                                                                                     | ✓                                                                |                                        |
| Transfer admin                                                                                    | ✓                                                                |                                        |
| [Manage billing](https://docs.warp.dev/support-and-community/plans-and-billing/plans-and-pricing) | ✓                                                                |                                        |