Skip to main content
Teams and projects provide the organizational structure for your secrets within a workspace.

​
Teams

Teams are groups within your workspace that contain projects. They typically mirror your company structure. For example, “Backend”, “Frontend”, “Infrastructure” or “Data Engineering”. Teams serve two purposes:
  1. Organization — group related projects together
  2. Access control — restrict a member’s access to specific teams (see Scoped access)

​
Managing teams

Teams are managed from workspace settings. Only Admins can create, rename or delete teams.
A team can only be deleted when it contains no projects. Move or delete all projects in a team before deleting it.

​
Projects

A project represents a single application, service or repository. It belongs to a team and contains environments and secrets.

​
Creating a project

When creating a project, you specify:
  • Name — the project name (up to 32 characters)
  • Slug — a URL-friendly identifier for the project
  • Team — the team the project belongs to
New projects come with default environments (e.g. development, staging, production).

​
Project dashboard

The project dashboard shows your secrets in a table with one column per environment. From here you can:
  • View and search secrets using fuzzy search
  • Show or hide secret values
  • Add, edit or delete secrets
  • Navigate to environment settings and sync configuration
Deleting a project removes all its environments, secrets and sync configurations permanently.