---
title: "Edit a Team"
description: "Learn how to edit an existing team in Contentstack."
url: "https://www.contentstack.com/docs/administration/edit-a-team"
product: "Contentstack"
doc_type: "guide"
audience:
  - developers
  - admins
version: "current"
last_updated: "2026-07-30"
---

# Edit a Team

You can edit an existing team by updating its name, description, assigned roles, or membership.

## Prerequisites

*   [Contentstack account](https://www.contentstack.com/login/)
*   Organization [Owner or Admin](/docs/administration/about-administration-roles) permissions
    
    **Note**: Only the Organization **Owner** or **Admin** can edit teams created by other stakeholders.
    
*   An existing [team](/docs/administration/create-a-team)

## What You Will Learn

*   How to update a team's name and description.
    
*   How to update a team's assigned Administration, product, and project-level roles.
    
*   How to add or remove users on a team.
    

## Edit a Team

To edit a team, log in to your [Contentstack account](https://www.contentstack.com/login) and perform the following steps:

1.  Navigate to **Administration** through the App Switcher, and select **Teams**.
2.  In the **Actions** column for the team you want to edit, click the vertical ellipsis, then click the **Edit** option (pencil icon).
3.  On the team page, you can:
    1.  Update the **Team Name** or **Description**.
    2.  Update the assigned Administration and product roles, and add or remove project-level roles for stacks, spaces, or AgentOS projects.
    3.  Add or remove users. For details, refer to the Invite Users section in the [Create a Team](/docs/administration/create-a-team) document.

When you modify settings in the **Team** tab, click **Save** to apply the changes. In the **Users** tab, changes are immediate; there is no Save button, and you can add or remove users directly.

## Related Resource

*   [Administration API: Edit a team](/docs/developers/apis/administration-api/teams#update-a-team)