Amazon CodeCatalyst is no longer open to new customers. Existing customers can continue to use the service as normal. For more information, see [How to migrate from CodeCatalyst](migration.md).

# Allowing project access using teams
<a name="projects-teams"></a>

After you create a project, you can add teams. Teams allow you to group users so that they can share permissions and manage projects, issue tracking, roles, and resources in CodeCatalyst as project and space members.

You must have the **Project administrator** role to manage teams for your project.

Teams are also managed at the space level in CodeCatalyst. To learn more about teams in spaces, see [Allowing space access using teams](managing-teams.md). 

**Topics**
+ [Adding a team to a project](projects-teams-add.md)
+ [Granting project roles for a team](projects-teams-project-roles.md)
+ [Removing a project role for a team](projects-teams-remove.md)

# Adding a team to a project
<a name="projects-teams-add"></a>

You can manage teams where the team members can access resources in your project.

On the members page for space and project users, users can have multiple roles. Users with multiple roles will show an indicator when they have multiple roles, and they will be displayed with the role with the most permissions first.

**To add a team**

1. Open the CodeCatalyst console at [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navigate to your project. Choose **Project settings**, and then choose **Teams**.

1. Choose **Add team**.

1. In **Team**, choose a team from the list of teams available.

1. Under **Project role**, choose a role from the list of project roles available in CodeCatalyst.
   + **Project administrator** — For details, see [Project administrator role](ipa-role-types.md#ipa-role-project-admin).
   + **Contributor** — For details, see [Contributor role](ipa-role-types.md#ipa-role-contributor).
   + **Reviewer** — For details, see [Reviewer role](ipa-role-types.md#ipa-role-reviewer).
   + **Read only** — For details, see [Read only role](ipa-role-types.md#ipa-role-read-only).

1. Choose **Add team**.

# Granting project roles for a team
<a name="projects-teams-project-roles"></a>

A team can have role permissions, such as **Power user**, in a space. You can change the space role for a team, but note that all members of the team will inherit those permissions.

**To add or change a project role**

1. Open the CodeCatalyst console at [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navigate to your space. Choose **Project settings**, and then choose **Teams**.

1. To change a role, choose the selector next to the team in this list, and then choose **Change role**. To add a role, choose **Add project role**. In **Project**, choose the project you want to add and in **Role**, choose the role. Choose one of the available project roles:
   + **Project administrator** - For details, see [Project administrator role](ipa-role-types.md#ipa-role-project-admin).
   + **Contributor** - For details, see [Contributor role](ipa-role-types.md#ipa-role-contributor).
   + **Reviewer** - For details, see [Reviewer role](ipa-role-types.md#ipa-role-reviewer).
   + **Read only** - For details, see [Read only role](ipa-role-types.md#ipa-role-read-only).

1. Choose **Save**.

# Removing a project role for a team
<a name="projects-teams-remove"></a>

In CodeCatalyst, you can view the project roles for your team. You can also view the members in a team. You can remove the project role for a team.

**To remove a project role**

1. Open the CodeCatalyst console at [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Navigate to your space. Choose **Project settings**, and then choose **Teams**.

1. Choose the **Project roles** tab.

1. Choose the role you want to remove.
**Important**  
Removing a role from a team removes the associated permissions for all users in the team.

1. Choose **Save**.