Skip to main content

Manage Workspaces

Overview​

A workspace is a sub-grouping within your organization. Its purpose is to group Kubernetes clusters (every cluster belongs to one workspace). Your organization has a default workspace, and Admins can create more.

A user belongs to exactly one organization and one workspace. There is no multi-workspace membership and no per-workspace roles.

Creating a Workspace​

  1. Go to Account Settings -> Workspaces (requires the Admin role)
  2. Click Create Workspace
  3. Enter a workspace name
  4. Click Create

Creating, renaming, and deleting workspaces all require the Admin role.

Renaming a Workspace​

  1. Go to Account Settings -> Workspaces
  2. Select the workspace to edit
  3. Change the name
  4. Save changes

Workspace Settings​

SettingDescription
NameDisplay name for the workspace
ClustersClusters that belong to this workspace

Workspaces do not carry their own Slack channel or a separate user list. Notification routing is configured per cluster and namespace inside the Slack integration. See Notification Routing.

Best Practices​

  • Name descriptively: use team names or environments (e.g., "Platform Production", "Payments Team")
  • Separate by concern: group clusters for different teams or environments to reduce noise
  • Start simple: begin with the default workspace and split later as your team grows

Next Steps​