> For the complete documentation index, see [llms.txt](/llms.txt).
> Markdown versions of each page are available by appending .md to any URL.

# Team management

Create or join a team to collaborate with others in Warp.

A Warp team is a group of users who collaborate through a shared workspace in Warp Drive. Teams share Workflows, Notebooks, Prompts, Rules, and Environment Variables, with role-based permissions for admins and members. Each Warp user can belong to one team at a time.

## 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](/support-and-community/plans-and-billing/pricing-faqs/).

Note

Currently, each Warp user can only be an admin or member of one team at a time.

![Teams Demo](https://i.ytimg.com/vi/8UmreUTTrkg/sddefault.jpg)

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

Note

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.

![Teams settings panel with a team name input field and Create button](/_astro/team-creation-settings.B5mqDnRv_ZccBus.webp?dpl=dpl_MV63uNFUhdjAGoLVXkvwsGQVcaHQ)

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](/knowledge-and-collaboration/teams/#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.

Caution

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](/support-and-community/plans-and-billing/pricing-faqs/#what-counts-as-a-team-member-and-how-does-billing-work-for-members).

![Teams settings panel](/_astro/teams-invite-demo.DVj00gNK_Z1FHIpp.webp?dpl=dpl_MV63uNFUhdjAGoLVXkvwsGQVcaHQ)

Teams settings panel.

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.

Caution

A team can’t be deleted while it has unused add-on credits. Before you can delete the team, all add-on credits tied to it must be used up or expired. If you need to remove unused credits to delete the team, contact [support@warp.dev](mailto:support@warp.dev).

On Build, Max, and Business plans, [add-on credits](/support-and-community/plans-and-billing/add-on-credits/) are scoped to each individual user but **tied to the team** they were purchased under. Membership changes affect access:

-   **A user leaves a team** - You lose access to any add-on credits tied to that team. If you rejoin the same team later, you regain access to any unused, non-expired credits. The admin pays a prorated rate for your seat on rejoin.
-   **An admin removes a member** - That member loses access to any add-on credits tied to the team. If they rejoin later, they regain access to any unused, non-expired credits. The admin pays a prorated rate for the seat when the user rejoins.
-   **An admin deletes the team** - Any remaining add-on credits tied to the team are no longer usable.

Add-on credits require an active subscription. Downgrading to the Free plan forfeits access to add-on credits tied to your team.

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

Note

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](/support-and-community/plans-and-billing/pricing-faqs/#what-counts-as-a-team-member-and-how-does-billing-work-for-members).

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

Caution

If you’re a Team admin, and you choose to [delete your Warp](/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.

| Action | Admin | Member |
| --- | --- | --- |
| Description | The Warp user who created the team. There can only be one. | Team members who belong to the team. |
| Create a team | ✓ |  |
| Restrict by domain | ✓ |  |
| Invite members | ✓ | ✓ |
| Remove team members | ✓ |  |
| Leave a team |  | ✓ |
| Delete a team | ✓ |  |
| Transfer admin | ✓ |  |
| [Manage billing](/support-and-community/plans-and-billing/plans-pricing-refunds/) | ✓ |  |
