Terminal > Knowledge and collaboration
Team management
# Team management import VideoEmbed from '@components/VideoEmbed.astro'; 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. ::: <VideoEmbed url="https://www.youtube.com/watch?v=8UmreUTTrkg&start=199s&end=277s" title="Teams Demo" /> ## 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. :::  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). ::: <figure>  <figcaption>Teams settings panel.</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. 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/) | ✓ | |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?
Section titled “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 and see our Pricing FAQ.
Creating a team
Section titled “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.
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 for more info.
Inviting new team members
Section titled “Inviting new team members”Under Settings > Teams you can copy the invite link for your Warp team and paste it to your clipboard.
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
Section titled “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
Section titled “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
Section titled “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.
On Build, Max, and Business plans, 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
Section titled “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.
Transferring team admin
Section titled “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
Section titled “Team roles and permissions”| 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 | ✓ |