Workspaces
A workspace is the top-level organizational unit in Contentrain Studio. It groups your projects, team members, billing, and GitHub App installation into a single boundary.
Workspace Types
Studio has two workspace types:
Personal Workspace
Every user gets a personal workspace automatically when they sign up. This workspace:
- Is created on your first sign-in, with any method (GitHub, Google, or magic link)
- Has
type: primaryin the system - Cannot be deleted (it is tied to your account)
- Serves as your default workspace if no other is selected
Team Workspace
You can create additional team workspaces for collaboration:
- Has
type: secondaryin the system - Can be renamed, configured, and deleted
- Supports multiple members with different roles
- Has its own billing plan and GitHub App installation
Workspace Dashboard
When you navigate to /w/:slug, you see the workspace dashboard. This page displays:
- A header with the workspace name and project count
- Two action buttons: Use Template and Connect repository
- A grid of project cards showing your connected repositories
- Empty states when no GitHub App is installed or no projects exist

Empty States
The dashboard shows contextual empty states:
- No GitHub App installed — prompts you to install the Contentrain GitHub App with an illustration and action button
- App installed but no projects — prompts you to connect a repository or start from a template
Creating a Workspace
To create a new team workspace:
- Open the workspace switcher in the sidebar and click Create workspace, or open the command palette with
Cmd+K(orCtrl+K) and run "Create workspace" - Enter a workspace name
- The workspace is created and you are switched to it
TIP
Studio derives the URL slug from the name. Slugs must be unique and URL-safe, and form part of your workspace URL: /w/your-slug. You can change the slug later in the Overview tab.
Switching Workspaces
You can switch between workspaces in several ways:
- Sidebar: Click the workspace name in the sidebar to open the switcher
- Command palette: Press
Cmd+Kand search for a workspace name - Direct URL: Navigate to
/w/:slugdirectly

Studio remembers your last active workspace and restores it on your next visit.
Workspace Settings
Access workspace settings from the sidebar Settings link or by navigating to /w/:slug/settings. Settings are organized into tabs: Overview, Members, Billing, GitHub, Connected apps, and AI. The Members and GitHub tabs are visible to workspace owners and admins only, and the AI tab is hidden in self-hosted Community Edition. (Your personal profile lives separately in account settings.)
Overview
General workspace information:
- Workspace name (editable)
- Workspace slug (editable; changing it updates every workspace URL)
- Plan card (on managed deployments, click it to compare or change plans)
- Danger Zone: delete workspace (secondary workspaces, owner only)

Members
Team management:
- View all workspace members and their roles
- Invite new members by email
- Change member roles (Admin or Member; owner only)
- Assign members to projects (Project Access)
- Remove members
- Resend pending invitations
See Team Management for details.
Billing
Subscription and plan management:
- Current plan and billing state
- Trial status and days remaining
- Upgrade/downgrade options
- Customer portal access (owners and admins; every member can see the plan and usage)
See Billing & Plans for details.
GitHub
GitHub App integration:
- Current installation status
- Link to install or reconfigure the GitHub App
- Connected repositories overview

Connected apps
Third-party applications (Claude, ChatGPT, Codex) that signed in to the workspace with OAuth over remote MCP:
- Copy the workspace's remote MCP endpoint and the connect snippets
- Review connected apps and the scopes they were granted
- Disconnect an app at any time
API keys for CI and headless agents are not here: they live in each project's settings (Project settings → API keys). See Connected Apps and the MCP Connector.
AI
Your own Anthropic API key (BYOA, Bring Your Own API Key). It is personal: it is encrypted, visible only to you, and each member adds their own.
- Add your own Anthropic API key
- View and delete your key
Plans without BYOA see an upgrade prompt in this tab; Community Edition hides it.
See AI Chat for details.
Workspace Hierarchy
Understanding how workspaces relate to other entities:
Key Rules
- A workspace owns its projects — deleting a workspace removes all its projects
- The workspace's GitHub App installation determines which repositories are available to connect
- Billing is per-workspace — each workspace has its own plan
- Members are invited at the workspace level and then assigned to specific projects
Deleting a Workspace
WARNING
Deleting a workspace permanently removes all its projects, content configurations, and member assignments. This action cannot be undone.
To delete a secondary workspace:
- Navigate to Settings > Overview
- Scroll to the Danger Zone (visible to the workspace owner only)
- Click Delete Workspace
- Type the workspace name to confirm. Optionally switch on Also uninstall GitHub App (shown when the workspace has a GitHub App installation) and Also cancel active subscription (shown when it has one)
Personal (primary) workspaces cannot be deleted — they are removed only when you delete your account.
Transferring Ownership
Workspace owners can transfer ownership to another Admin member from their account settings, not from workspace settings:
- Click your name at the bottom of the sidebar and open the Account tab
- In the Danger Zone, click Transfer Ownership next to the workspace
- Choose the new owner
- The previous owner becomes an Admin
Only team (secondary) workspaces with other members appear there; a personal workspace cannot be transferred. See Account Settings.
TIP
Only Admin members can receive ownership transfers. Promote a Member to Admin first if needed.
Next Steps
- Projects — Connect repositories and create projects
- Team Management — Manage members and roles
- Billing & Plans — Understand plans and subscriptions