> For the complete documentation index, see [llms.txt](https://docs.warp.dev/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.

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

Note

Users can belong to multiple teams when their Enterprise account uses a [multi-team workspace](https://docs.warp.dev/enterprise/team-management/workspaces/).

![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](https://docs.warp.dev/_astro/team-creation-settings.B5mqDnRv_ZccBus.webp?dpl=dpl_6gHUvXMh8oZJVunjNUZTjqNUZ2Tz)

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](https://docs.warp.dev/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.

### Warp Terminal and local agent teams

Upgrading a team to a paid Warp Terminal and local agent subscription includes your own account and all active members in billing. New members also become paid seats. Charges are prorated for the time each member has access during the monthly or annual cycle; a member joining halfway through a monthly cycle incurs half of that seat’s monthly fee.

### Warp Factories teams

The Scale plan for Warp Factories charges one team subscription rather than a subscription fee for each member. Factory runs use shared team or workspace funding, not each member’s included personal allowance. Enterprise member billing follows your contract.

Review [member billing](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) before inviting members.

![Teams settings panel](https://docs.warp.dev/_astro/teams-invite-demo.DVj00gNK_Z1FHIpp.webp?dpl=dpl_6gHUvXMh8oZJVunjNUZTjqNUZ2Tz)

Teams settings panel.

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

## Restricting team invites by domain

You can restrict 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 purchased usage. Before you can delete the team, that balance must be used or removed. Contact [support@warp.dev](mailto:support@warp.dev) if you need help removing unused usage.

Purchased usage stays tied to the team that bought it. Leaving or being removed ends your access to that balance; rejoining restores access to unused, unexpired usage. On per-seat subscriptions, rejoining adds a prorated seat charge for the remaining billing cycle. See [usage when team membership changes](https://docs.warp.dev/support-and-community/plans-and-billing/add-on-credits/#when-team-membership-changes) and [member billing](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).

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

Users who join through discoverability follow the same [member billing rules](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) as invited members. Per-seat subscriptions add a prorated seat charge.

## 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](https://docs.warp.dev/support-and-community/privacy-and-security/privacy/#delete-your-account-and-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](https://docs.warp.dev/support-and-community/plans-and-billing/pricing-faqs/#how-do-i-manage-my-billing) | ✓ |  |

Multi-team workspaces use [workspace roles](https://docs.warp.dev/enterprise/team-management/workspaces/#workspace-roles) for company-wide administration.
