Team & roles
A workspace is how you share projects with other people. Everyone in a workspace has a role, and that role decides what they can do — it's the setting behind almost every "you don't have permission to do that" you'll ever see in Berrybell.
Your own role is shown in the workspace settings header.
The four roles
| Role | Can do |
|---|---|
| Owner | Everything, including deleting the workspace. |
| Admin | Everything an editor can do, plus manage members and invitations, billing and plan changes, workspace settings and single sign-on, and a few project settings: turning on and managing sign-in for your app's users, custom email domains, app email (notifications and email templates), and disconnecting Stripe. |
| Editor | Create, edit and delete projects. This is the level most build actions require. |
| Viewer | Read-only. |
Most day-to-day work — building in the Studio, connecting a database, adding a custom domain, publishing — needs editor. A few things sit above it: billing, members, workspace settings and single sign-on, plus turning on and managing sign-in for your app's users, custom email domains, app email and disconnecting Stripe payments. Those need admin.
Restricted actions aren't just hidden in the interface. A viewer cannot make a change by any route, including one that skips the UI.
Inviting people
Admins and owners invite by email from Members & access in workspace settings, and choose the role the person lands with — admin, editor or viewer. The role starts at editor. (You can't invite a second owner from the interface.)
The invitee gets an email with an accept link. If they're already signed in with the invited address, opening it joins them straight away. If they're signed out, it opens Create your account, with a note at the top: "You've been invited to a workspace. Sign in (or sign up) with the invited email to join."
- They must use the invited address. Opening the link while signed in to a different account, or signing in with one, shows "Failed to set up workspace: You are not the recipient of the invitation", and they don't join. The invitation stays open: sign out, open the link again, and sign in with the invited address.
- If the address already has an account, pressing Continue shows "teammate@example.com already has an account. Sign in to join the workspace.", with their own address.
- Signing up with an email and password means confirming the address first. The confirmation link carries the invitation with it, so clicking it signs them in and joins them to the workspace.
Accepting joins them to the workspace and makes it their active one; no new workspace is created for them. The screens themselves are covered in Signing in to Berrybell.
Pending invitations
An invitation expires 48 hours after it's sent. It stays under Pending invitations, but its link then shows "Failed to set up workspace: Invitation not found". Re-sending it gives it another 48 hours, even when the hourly limit below stops the email, so re-send before copying the link of an older invitation.
An invitation that hasn't been accepted yet can be:
- re-sent (Resend invite email), if the email went astray;
- cancelled (Cancel invitation); or
- copied as a link (Copy invite link), to send through whatever channel you like when email isn't getting through.
These are the icon buttons on the invitation's row; the names above are their tooltips. One address gets at most 5 invitation emails per hour. Past that, the resend button still turns into a check mark reading Email resent, but nothing goes out, so copy the link instead.
Managing members
In the members list on Members & access, admins and owners can change someone's role from a dropdown or remove them. You can't change or remove your own row, or an owner's row. Everyone below admin sees the same roster, read-only.
Emails your team receives
- Invitation sent — to the person you invited.
- Invitation accepted — to whoever sent it.
- Role changed and removed from workspace — to the person affected.
- Welcome to BerryBell — to a new person, when the first workspace they create actually receives the one-time welcome credits. It states the amount added. It isn't sent for later workspaces, or if no credits were added.
Owners and admins also get emails about the plan, charges and credits — see Billing.
Workspace settings
- Rename the workspace — owners and admins.
- URL slug and workspace ID are shown read-only; they're handy to quote when you contact support.
- Delete the workspace — owner only, and you have to type the workspace name exactly. It permanently deletes every project in it.
Seats
On plans that bill per seat, adding a member can increase the purchased seat count automatically, with a prorated charge, and owners and admins are emailed when that happens. Seats are purchased capacity with a plan minimum, not a mirror of your member count — and they never shrink automatically. Reducing them is an explicit plan change. See Billing.
If a plan change is already scheduled on the subscription, seat growth waits and catches up the next time someone joins.
Opening a workspace you're not in
Opening the settings URL for a workspace you don't belong to shows a no-access screen with a link back to your dashboard. Opening the settings URL for one you do belong to switches your active workspace to it.
Next steps
- Payments, invoices and plan changes: Billing
- How workspaces and projects fit together: Projects & workspaces