Inviting users and managing roles
Invite someone to your workspace, choose the role that gives them the access they need, and manage their access afterwards. For background on how workspaces fit together, see Workspaces.
Before you start
- You need the Workspace Admin role on the workspace you're inviting people into. Only an admin can invite users, change roles, or remove users.
- Have the new user's email address ready. They do not need a CloudPress account yet — one is created for them when they accept the invitation.
Invite a user
-
Open the workspace's settings. In the left-hand navigation, choose Workspace settings. This opens the page where contacts, users, and sub-workspaces are managed.
-
Open the Team tab. Choose the Team tab, then find the Users card (subtitle User Management and Access). It lists everyone with access to the workspace, along with any pending invitations.
-
Start the invitation. Click Invite in the top-right corner of the Users card. This opens the Invitations form. Its subtitle reads Invite a user to
<your workspace name>, confirming which workspace the invite is for. -
Enter the email address. Type the invitee's email into the Email field.
-
Choose a role. Pick one of the roles from the Role list (the choices are shown as radio buttons). The page also shows a permissions table so you can compare what each role can do before you choose — see How roles work below.
-
Send the invitation. Click Invite user. If asked, re-confirm your identity with your passkey or password. CloudPress emails the invitation and you'll land on the General tab with a confirmation. The new invitation appears in the Pending Invitations list on the Team tab.
The invitee receives an email with a link to accept or decline, and is granted the role you chose when they accept. For a walkthrough of the invite screen itself, see Inviting a user.
Invitations expire after one week
A pending invitation is valid for 1 week. If it isn't accepted in time it expires and is removed automatically. You can re-send it before then (see Manage pending invitations).
How roles work
When you invite someone, you assign them exactly one role on the workspace. Each user holds one role per workspace, and the same person can hold different roles in different workspaces. The five built-in roles below are listed from least to most access. Every role can view site details; each higher role adds more capabilities.
| Capability | Billing Manager | Site Viewer | Site Manager | Site Admin | Workspace Admin |
|---|---|---|---|---|---|
| View site details | ✓ | ✓ | ✓ | ✓ | ✓ |
| Edit site | ✓ | ✓ | ✓ | ||
| Create site | ✓ | ✓ | |||
| Delete site | ✓ | ✓ | |||
| Manage billing details | ✓ | ✓ | ✓ | ||
| Manage user access | ✓ | ||||
| Create sub-workspaces | ✓ |
Roles can change later
Picking a role isn't permanent. An admin can change someone's role at any time from the Team tab (see Change a user's role), so start with the least access that lets the person do their job.
Inherited roles
If your account has sub-workspaces, a role granted on a parent workspace cascades down to its child workspaces automatically. In the Users list on a child workspace, an inherited role is shown with a badge naming the workspace it came from (or simply marked as Inherited).
An inherited role cannot be removed on the child workspace — to take that access away you change it on the parent workspace where it was granted. You can, however, edit an inherited role on the child: doing so detaches it from the parent, and from then on it's an independent role on the child workspace that no longer follows the parent's role.
Manage existing users
All current users appear in the Users card on the Team tab of the workspace settings, in a table showing each person's Name, Email, Role, and the date they were Added On. Your own row is tagged with a Me badge.
Change a user's role
- Open Workspace settings and choose the Team tab.
- In the row for the user you want to change, click Edit. This opens a page
titled
<name>'s Access. - Pick the new role from the Role list.
- Click Update.
You can't edit your own role from this screen. Editing an inherited role here is allowed, but it detaches that role from the parent workspace (see Inherited roles); if you'd rather keep it linked to the parent, change it on the parent workspace instead.
Remove a user
- Open Workspace settings and choose the Team tab.
- In the user's row, click Remove.
- Confirm in the dialog that appears ("This user will no longer have access to this account.").
Removing a user revokes their access immediately
Removing a user ends their access to the workspace right away, including any active sessions. You can't remove your own access this way — instead, use the Leave Workspace action on your own row. You also can't remove a role that was inherited from a parent workspace; that has to be changed on the parent.
Manage pending invitations
Invitations that haven't been accepted yet appear in the Pending Invitations list on the Team tab, showing the invitee's email, the role you chose, when it was sent, and when it expires. For each pending invitation you can:
- Re-send — emails the invitation again (useful if the invitee never received it). Check the email address shown is correct before re-sending.
- Cancel — withdraws the invitation so the link no longer works.
Using the API
To manage users through the API, see Users and Accounts.
Next steps
- Review how workspaces and sub-workspaces fit together
- For automation, explore the Users API and Accounts API