Workspaces
A workspace is the container for everything you do in CloudPress. Your sites, domains, DNS zones, backups, billing, and the people you collaborate with all live inside a workspace. You can belong to more than one, and you switch between them as you work.
Workspace = account
"Workspace" is the name you'll see in the dashboard. In the Accounts API the same thing is called an account, and a child workspace is called a sub-account.
What lives in a workspace
Almost everything in CloudPress belongs to exactly one workspace:
- Sites — your WordPress installations.
- Domains and DNS — the domains attached to those sites and their DNS zones.
- Billing — the subscription, payment method, and invoices that pay for the sites in the workspace.
- People and roles — the users who can access the workspace and what each of them is allowed to do.
- Contacts — the owner, billing, and technical contacts recorded for the workspace.
Because everything is scoped to a workspace, the workspace you're currently in decides which sites and domains you see in the sidebar and which billing you're looking at. There is no combined "all workspaces at once" view — you're always working inside exactly one active workspace at a time, and you switch to see the others.
Finding your workspaces
To see every workspace you belong to, open the account switcher in the sidebar (its trigger shows the name of your current workspace) and click View All in the Workspaces panel that appears. This opens the full workspace list (headed My Workspaces), which shows each workspace by Name alongside Your Role in it, and lets you jump into any of them.
| Column | What it shows |
|---|---|
| Name | The workspace name. Sub-workspaces are nested underneath their parent. |
| Your Role | The role you hold in that workspace (for example Workspace Admin). An Inherited badge means the role was granted on a parent workspace and flows down to this one. |
| (action) | A Switch To Workspace button, or an Active Workspace badge if it's the one you're currently in. |
To create another top-level workspace, click New Workspace on this page. (To create a sub-workspace under one you already manage, use Create Sub-Workspace on that workspace's Sub-workspaces tab instead — see Sub-workspaces.)
Switching between workspaces
Switch the active workspace from the account switcher in the sidebar: pick a recent
workspace, filter them with the Search workspaces… box, or hover a workspace that
has sub-workspaces to reach its children. You can also click Switch To Workspace
next to any workspace on the My Workspaces page. CloudPress confirms with a
"Switched to <workspace name>" message, and the sidebar then shows the sites,
domains, and billing of the workspace you moved into.
The same login, many workspaces
You sign in once. Switching workspaces does not log you out or require a second login — it just changes which workspace's sites and settings you're looking at. Your role can differ from one workspace to the next, so what you're allowed to do may change as you switch.
Workspace settings
Each workspace has its own settings page, reached from Workspace settings in the sidebar. It's where you review and manage the workspace itself rather than any single site. The page is organized into tabs:
- General — the Workspace details card, with the Workspace ID (and a Copy button) and an Edit button that lets an admin rename the workspace and change its owner, billing, and technical contacts and a few other settings, such as notification webhooks. Admins also see a Delete workspace card here.
- Team — the Users card (subtitle User Management and Access): everyone with access to the workspace and their roles, any Pending Invitations, and an Invite button to add more (admins only).
- Contacts — the Contact roles card, showing the Owner Contact, Billing Contact, and Technical Contact on file, plus a Contacts list of everyone you've added, with a Create button.
- Brands — only shown to admins of reseller workspaces; covers white-label branding (see Resellers).
- Sub-workspaces — workspaces nested beneath this one, each with a Switch To Workspace button, and a Create Sub-Workspace button (admins only). Creating a sub-workspace that the parent manages and bills for is a reseller feature — see Sub-workspaces and resellers.
- Activity — admins only: the changes made to the workspace, such as its parent, billing, plan, and settings.
- Moves — admins only: Move services and, when you may move this workspace, Move workspace, plus a history of Recent moves. For moving services, see Moving services between workspaces.
Users and roles at a glance
Each person in a workspace holds exactly one role there, and that role decides what they can see and do. The same person can hold a different role in a different workspace — being an admin in one workspace doesn't make you an admin everywhere.
CloudPress has five built-in roles, from least to most access:
| Role | What it's for |
|---|---|
| Billing Manager | Read-only on sites, plus read access to billing and pricing. Good for a finance contact who needs to see invoices and costs. |
| Site Viewer | View site details only. |
| Site Manager | View and edit sites. |
| Site Admin | Everything Site Manager can do, plus create and delete sites, and manage billing. |
| Workspace Admin | Full control: everything above, plus inviting and managing users and creating sub-workspaces. |
Two names for the top role
The most powerful role is labelled Account Admin in some places and Workspace Admin in others — they're the same role. Only this role can manage user access (invite people, change roles, remove users) and create sub-workspaces.
Inviting people, changing their roles, and removing them are workspace administration tasks rather than concepts — for the step-by-step, see Inviting users and managing roles.
Inherited roles cascade down
If a workspace has sub-workspaces, a role granted on the parent automatically flows down to the children, where it's shown with an Inherited badge. You change an inherited role on the parent where it was granted, not on the child.
Sub-workspaces and resellers
A workspace can contain sub-workspaces — child workspaces nested beneath it. Sub-workspaces are available to resellers: a reseller creates one per customer so each customer's sites and billing stay separate while the reseller manages them all.
Two settings shape how a sub-workspace behaves:
- Inherit Billing — offered when the parent is a reseller. When on, the sub-workspace is billed to its parent: the parent pays for the child's usage, and people in the child workspace don't see a separate billing dashboard. When off, the sub-workspace has its own payment method and is billed independently.
- Inherited roles — as noted above, a role on the parent cascades down to the child.
When you create a sub-workspace, you become its Workspace Admin.
Reseller and white-label branding features are covered in detail on the Resellers page.
Trial workspaces
A workspace can be a trial. A trial workspace is limited compared with a paid one — for example, it has no billing dashboard, and you're prompted to upgrade before you can manage billing or use the features a trial doesn't include.
Leaving a workspace
If you no longer need access to a workspace, you can remove yourself from it using the Leave Workspace action on your own row in the Users card on the Team tab. A couple of guardrails apply:
- You can't leave a workspace if you're its only remaining user, or if it's the only workspace you belong to.
- You can't leave by way of a role that was inherited from a parent workspace — that has to be changed on the parent.
Leaving removes your access
Once you leave a workspace you lose access to it, and another admin would have to re-invite you to get it back. Leaving a workspace does not delete the workspace or its sites — it only removes you from it.
Using the API
In the API, a workspace is an account. To work with workspaces through the API, see Accounts.