Workspaces & Teams — Docs

What workspaces are

A workspace is a multi-tenant container that isolates your data from other organizations. Each workspace maintains its own:

Status pages and their components, incidents, and subscribers
Uptime monitors (HTTP checks and heartbeats)
API tokens scoped to the workspace
Team members and role assignments
Billing subscription and usage limits
Audit log of all actions

A single user account can belong to multiple workspaces. This is useful if you manage infrastructure for several organizations or want to keep production and staging environments separate.

Creating a workspace

When you sign up for Beacon, your first workspace is created automatically. To create additional workspaces, navigate to the workspace switcher in the sidebar and click Create Workspace.

You only need to provide a name. Beacon auto-generates a URL-safe slug from the name, which is used in public status page URLs and API endpoints. You can edit the slug before saving.

To switch between workspaces, click the workspace name in the top of the sidebar. All workspaces you belong to are listed there.

Workspace limits

The number of workspaces you can own depends on your plan:

Plan	Owned workspaces
Free	`1`
Pro	`5`

These limits apply to workspaces you own. You can be invited as a member to an unlimited number of workspaces owned by others, regardless of your plan.

Team roles

Every team member in a workspace is assigned one of four roles. Roles determine what actions a member can perform.

Permission	Owner	Admin	Member	Viewer
View status pages, incidents, and components	Yes	Yes	Yes	Yes
Create and edit status pages	Yes	Yes	Yes	No
Create and edit components	Yes	Yes	Yes	No
Create and edit incidents	Yes	Yes	Yes	No
Manage API tokens	Yes	Yes	No	No
Send and manage invitations	Yes	Yes	No	No
Access billing and subscription	Yes	No	No	No
Transfer workspace ownership	Yes	No	No	No
Delete workspace	Yes	No	No	No

Inviting members

To invite someone to your workspace, navigate to Settings and open the Invitations tab. Enter the recipient's email address and select the role you want to assign.

When you send an invitation, Beacon delivers an email containing a secure, single-use token link. The invitation expires after the configured period if the recipient does not act on it.

Pending invitations are listed in the Invitations tab. Owners and admins can revoke a pending invitation at any time before it is accepted.

Accepting invitations

When a recipient clicks the invitation link in their email, they are directed to Beacon. If they already have an account, they log in and are immediately added to the workspace with the assigned role. If they do not have an account, they are prompted to create one first, and then join the workspace upon completing registration.

Team member limits

The maximum number of team members per workspace depends on your plan:

Plan	Team members
Free	`3`
Pro	Unlimited

The member count includes the workspace owner. If you are on the Free plan with 3 members and need to add a fourth, you must upgrade to Pro or remove an existing member.

Removing members

Team members can be removed from a workspace in Settings under the Members tab. The rules for who can remove whom are as follows:

Owners — Can remove any team member (admins, members, and viewers).
Admins — Can remove members and viewers, but cannot remove other admins or the owner.
Members and Viewers — Cannot remove anyone.

The workspace owner cannot be removed. To change the owner, use the ownership transfer process described below.

Transferring ownership

Only the current workspace owner can transfer ownership. To initiate a transfer, go to Settings and look for the Transfer Ownership section. You will be asked to enter the email address of the new owner to confirm the action.

The new owner must be an existing admin in the workspace. If the person you want to transfer ownership to is currently a member or viewer, promote them to admin first.

After the transfer completes, the previous owner is demoted to admin and the new owner gains full control, including billing access and the ability to delete the workspace.

Audit logging

Every create, update, and delete action within a workspace is recorded in the audit log. You can review the full history in Settings under the Activity tab.

Each log entry includes:

The team member who performed the action
A description of what was done
The timestamp of the action

Examples of logged events:

Incident created, updated, or resolved
Component added, status changed, or removed
Status page created or settings modified
API token generated or revoked
Invitation sent, accepted, or revoked
Team member role changed or member removed
Monitor created, paused, or deleted

Audit log entries are immutable. They cannot be edited or deleted by any team member, including the workspace owner.

Read-only mode

A workspace can enter read-only mode under two circumstances:

Payment failure — If a subscription payment fails, Beacon provides a 7-day grace period during which the workspace remains fully writable. If the payment is not resolved within those 7 days, the workspace becomes read-only.
Plan limit exceeded — If a downgrade causes your usage to exceed the new plan's limits, the workspace becomes read-only until you reduce usage or upgrade.

While in read-only mode, you can still view all data and your public status pages remain live. However, you cannot create or edit incidents, components, monitors, or any other resources until the billing issue is resolved.