Skip to main content
Feature AvailabilityThis feature is available as part of the Advanced User Management add-on. You can upgrade your organization to this add-on in the Console.For details about the other features included in this add-on, see the Advanced User Management add-on help topic section; for pricing information, see the Upsun pricing page.
Organizations on Upsun are made up of both projects and users. While organizations by themselves allow you to assign project and environment type permissions to individual users on individual projects, having many users and many projects calls for another method to group common access control settings. Teams provide a grouping that connects a subset of an organization’s users to another subset of that organization’s projects. That relationship enables organization owners to set default project and environment type access settings for each user and project from one place. There is no limit to the number of teams that can be defined within a single organization.

​
Create a new team

As an organization owner or member with Manage users permissions, you can create new teams. Teams must belong to an organization, so create one first. You can create new organizations with different payment methods and billing addresses and organize your projects as you want, but keep in mind that both users and teams are restricted to single organizations.
  1. Navigate to your existing organization.
  2. Open the user menu (your name or profile picture).
  3. Select Teams from the dropdown.
  4. Click + Create team.
  5. Enter the information for your team. Only the team name is required at this point, but you can define environment type permissions now if you’d like.
  6. Click Create team.

​
Delete an existing team

As an organization owner or member with Manage users permissions, you can delete existing teams. Note that deleting teams and deleting users are not equivalent. Deleting a team will remove member access permissions to projects described by the team, but it will not remove users from the organization (or your billing).
  1. Navigate to your existing organization
  2. Open the user menu (your name or profile picture).
  3. Select Teams from the dropdown.
  4. Find the team you want to delete under the Manage teams list, then click More.
  5. Click Delete team.
  6. Click Yes to confirm.

​
Manage team settings

As an organization owner or member with Manage users permissions, you can manage the settings of existing teams such as:

​
Team name

  1. Navigate to your existing organization.
  2. Open the user menu (your name or profile picture).
  3. Select Teams from the dropdown.
  4. Find the team you want to rename under the Manage teams list, then click More.
  5. Click Edit team.
  6. In the sidebar click the Edit link, and edit the team name.
  7. Click Save.

​
Project & environment type permissions

The primary purpose of teams is to allow organizations to quickly apply, audit, and update project and environment type permissions for groups of users.
  1. Navigate to your existing organization
  2. Open the user menu (your name or profile picture).
  3. Select Teams from the dropdown.
  4. Find the team you want to modify under the Manage teams list, then click More.
  5. Click Edit team.
  6. In the sidebar, you can:
    • Assign Project permissions by selecting the check box to make team members Project admins of every project added to the team.
    • Assign Environment type permissions by using the dropdowns to grant No access, Viewer, Contributor, or Admin rights to team members for Production, Staging, and Development project environment types.
  7. Click Save.

​
Team members

​
Add users to a team

To join a team, a user must already have been added to the organization, where their organization permissions are defined.
  1. Navigate to your existing organization.
  2. Open the user menu (your name or profile picture).
  3. Select Teams from the dropdown.
  4. Find the team you want to modify under the Manage teams list, then click More.
  5. Click Add user.
  6. Locate and select organization users from the dropdown.
  7. In the sidebar click the Edit link, and edit the team name.
  8. Click Add users.

​
Remove users from a team

Note that deleting users from teams and deleting users from organizations are not equivalent. Deleting users from a team will remove member access permissions to projects described by the team, but it will not remove users from the organization (or your billing).
  1. Navigate to your existing organization.
  2. Open the user menu (your name or profile picture).
  3. Select Teams from the dropdown.
  4. Find the team you want to modify under the Manage teams list, then click More.
  5. Click Edit team.
  6. Find the user you want to remove under the USERS tab view, then click More.
  7. Click Remove user.
  8. Click Yes to confirm.

​
Team access to projects

​
Adding projects to a team’s access

Option 1: Add projects to team with from Team settings
  1. Navigate to your existing organization.
  2. Open the user menu (your name or profile picture).
  3. Select Teams from the dropdown.
  4. Find the team you want to modify under the Manage teams list, then click More.
  5. Click Edit team.
  6. Click + Add projects.
  7. Select All projects, or choose individual projects from the dropdown.
    All projects refers to all existing projects. Any future project you create will need to be added to the team manually.
  8. Click Add to team.

Option 2: Add teams to project from project’s Access settings
  1. Navigate to your existing organization.
  2. Select the project you want to add to the existing team.
  3. Navigate to the project’s settings by clicking the Settings icon.
  4. Click Access settings under Project settings in the sidebar.
  5. Select the TEAMS tab in the Access list view.
  6. Click +Add to projects.
  7. Select All teams, or choose individual teams from the dropdown.
    All teams refers to all existing teams. Any future team you create will need to be added to the project manually.
  8. Click Add to team.

​
Remove project from team’s access

Option 1: Remove projects from a team with from Team settings
  1. Navigate to your existing organization.
  2. Open the user menu (your name or profile picture).
  3. Select Teams from the dropdown.
  4. Find the team you want to modify under the Manage teams list, then click More.
  5. Click Edit team.
  6. Find the project you want to modify under the PROJECTS tab view, then click More.
  7. Click Remove project.
  8. Select All projects, or choose individual projects from the dropdown.
  9. Click Yes to confirm.

Option 2: Remove teams from a project from project’s Access settings
  1. Navigate to your existing organization.
  2. Select the project you want to add to the existing team.
  3. Navigate to the project’s settings by clicking the Settings icon.
  4. Click Access settings under Project settings in the sidebar.
  5. Find the team under the TEAMS tab view, then click More.
  6. Click Remove team.
  7. Click Yes to confirm.
Last modified on March 11, 2026