# Teams

> A Safecube team gathers shipments of a workspace, to sort and filter them or, combined with the Teams scope of an Editor or a Viewer, to limit that member to the shipments of their teams.

A team gathers shipments of a Safecube workspace. The app calls them **Teams**; the API and the `groups` column of the CSV import call them groups. A team serves to sort shipments, by customer, business unit or product for example, and to limit what some Editors and Viewers see.

## Who can manage teams

| Gesture | Minimum role |
| ------- | ------------ |
| Create, rename and delete a team, add or remove its members | Admin |
| Add shipments to a team or remove them from the team settings | Admin |
| Add a shipment to teams from the shipment list, its details or its creation | Editor |
| Filter the shipment list by team | Viewer |

An Editor or a Viewer does not see **Teams** under **Workspace Settings**.

## How teams limit access

Adding a shipment to a team hides it from no one. Every member with the scope **All** sees every shipment, whatever its teams, so a team can be used only to sort shipments.

Access is limited in one case only: an Editor or a Viewer has the scope **Teams** and belongs to one or more teams. That member then sees only the shipments of their teams, with their documents and alerts. A shipment in no team is not visible to them.

- On the shipments of their teams, members keep the rights of their role: an Editor can edit them. A team gives no read-only access of its own.
- A member with the scope **Teams** and no team sees no data.
- A team with shipments and no member restricts nothing.
- Admins and Owners always have the scope **All** and cannot be members of a team.

The scope of a member is set in the Users page, as described in [Users and roles](/en/platform/workspace/users-and-roles).

## Open the Teams page

1. Select **Settings** at the bottom of the sidebar.
2. Under **Workspace Settings**, select **Teams**.

The page, **Team management**, shows the number of teams, **Search team** to find a team by name, and the list of teams with their **Name**, **Members** and **Shipments**. Select a column header to sort the list. **Table view** and **Grid view** switch between a table and cards; the choice is remembered. A link to `/settings?page=groups` opens the page too.

![Team management page in table view with four teams and the Create team button](https://docs.safecube.ai/media/images/shared/settings-groups--table.webp?v=a1aeae73)

When the workspace has no team, the page reads "No created teams" and offers **Create team**.

![Team management page reading No created teams, with the Create team button](https://docs.safecube.ai/media/images/shared/settings-groups--empty.webp?v=70212c1e)

## Create a team

1. On the **Teams** page, select **Create team**.
2. Enter a **Name**.
3. Select **Create**.

Safecube displays "Team created successfully." and opens the new team. A name already used reads "A team with this name already exists.".

![Create team dialog with the Name field](https://docs.safecube.ai/media/images/shared/modal-group-add--default.webp?v=4a140528)

## Rename or delete a team

1. Open **More options** on the row or the card of the team, or in the team itself.
2. Select **Edit name** to rename it in **Update team**, then **Update**; or select **Delete**, then **Delete** in **Delete team**. Deleting a team cannot be undone.

## Add or remove members

1. Select a team to open it. The team shows two panels, **Members** and **Shipments**.
2. Select **+ Add members**.
3. In **Search user**, find members by name or email. Each result shows the current scope of the member, **All** or **Teams**.
4. Select **Add members**.

Only Editors and Viewers can be added. When none is left to add, the dialog reads "No users with the editor or viewer role can be added to this team.". When a chosen member has the scope **All**, the dialog warns: "The following users currently have full workspace access. Adding them will restrict their access to this team only:".

![Team detail with the Members panel listing two members and the Shipments panel listing shipments](https://docs.safecube.ai/media/images/shared/settings-groups--details.webp?v=59ed7a86)

![Add members dialog with two chosen users and the warning about users with full workspace access](https://docs.safecube.ai/media/images/shared/modal-group-add-members--default.webp?v=6cce5e70)

To remove a member, open **More options** on their row in **Members**, select **Delete**, then **Delete** in **Remove member**.

## Add shipments to a team

A shipment can belong to several teams. You can add it from five places:

| Place | Gesture | Minimum role |
| ----- | ------- | ------------ |
| Team settings | **+ Add shipments** in the **Shipments** panel, choose the shipments, then **Add shipments** | Admin |
| Shipment details | **More options**, **Add team(s)**, described in [Shipment details](/en/platform/container-tracking/shipment-details) | Editor |
| Shipment list, one row | **Add team(s)** in the row menu | Editor |
| Shipment list, several rows | Select the rows, then **Teams** in the action bar, choose the teams and select **Add teams** | Editor |
| Shipment creation | The optional **Teams and custom properties** panel, or the `groups` column of a CSV import | Editor |

![Add shipments dialog of a team with two chosen shipments](https://docs.safecube.ai/media/images/shared/modal-group-add-shipments--default.webp?v=6484b158)

To remove a shipment from a team, open **More options** on its row in the **Shipments** panel of the team, select **Delete**, then **Delete** in **Remove shipment**.

## Filter shipments by team

In the filters of the shipment list, **Filter by teams** keeps the shipments of one or more teams. It shows only when the workspace has teams. The filters are described in [Shipment list](/en/platform/shipment-views/shipment-list).

## Limits

- A team has a name only: no description, colour or rights of its own.
- Rights come from the role of each member; a team cannot give read-only access.
- Admins and Owners cannot be added to a team.
- Editors and Viewers cannot open the team settings; they see the teams of a shipment in its details.
