# Managing Workspaces



Workspaces are the organizational unit in VitalSentinel. Each workspace contains domains and team members, and has its own billing plan.

## What is a Workspace? [#what-is-a-workspace]

A workspace is a container for:

* **Domains** - Websites you're monitoring
* **Team members** - People with access
* **Billing** - Subscription and usage
* **Integrations** - Connected services

## When to Use Multiple Workspaces [#when-to-use-multiple-workspaces]

### Separate Billing [#separate-billing]

Create separate workspaces when:

* Different clients should receive separate invoices
* Different departments have separate budgets
* You need to track costs separately

### Access Control [#access-control]

Separate workspaces help when:

* Different teams shouldn't see each other's domains
* Clients should only access their own data
* You need strict data separation

### Different Plans [#different-plans]

Each workspace has its own plan, useful when:

* Some projects need more features
* You want to test with a free workspace
* Projects have different resource requirements

## Creating a Workspace [#creating-a-workspace]

### New Workspace [#new-workspace]

1. Click the workspace dropdown in the sidebar
2. Click **Add Workspace**
3. Enter a workspace name
4. Select a plan
5. Complete payment (if not free)

### Workspace Naming [#workspace-naming]

Choose clear, descriptive names:

* Company name: "Acme Corp"
* Client name: "Client - BigCorp"
* Project name: "E-commerce Redesign"

## Workspace Settings [#workspace-settings]

Access workspace settings by clicking the settings icon next to your workspace name in the sidebar, or by navigating to any workspace page.

The sidebar shows these sections:

### General [#general]

* **Workspace Name** - Update the workspace name

### Members [#members]

* View team members
* Invite new members
* Manage roles

### Billing [#billing]

* View current plan and usage
* Upgrade or downgrade
* Manage payment via Stripe portal

### Integrations [#integrations]

Connect external services:

* Google Account (Analytics, Search Console)

## Switching Workspaces [#switching-workspaces]

If you belong to multiple workspaces:

1. Click the workspace dropdown in the sidebar
2. Select the workspace to view
3. The domain list updates automatically

## Workspace Limits [#workspace-limits]

Each plan has limits per workspace:

| Limit                | Free  | Starter | Lite  | Standard | Advanced |
| -------------------- | ----- | ------- | ----- | -------- | -------- |
| Domains              | 1     | 3       | 5     | 25       | 50       |
| RUM Page Views/mo    | 25K   | 100K    | 250K  | 2M       | 5M       |
| Analytics Events/mo  | 100K  | 1M      | 5M    | 25M      | 50M      |
| CrUX URLs            | 5     | 10      | 100   | 1,000    | 5,000    |
| Synthetic URLs       | 3     | 10      | 50    | 100      | 250      |
| Synthetic Locations  | 1     | 1       | 2     | 3        | 5        |
| Data Retention       | 6 mo  | 12 mo   | 16 mo | 24 mo    | 24 mo    |
| Min. Uptime Interval | 5 min | 5 min   | 5 min | 5 min    | 1 min    |

<Callout type="info">
  See [pricing](https://www.vitalsentinel.com/pricing) for current rates.
</Callout>

## Viewing Usage [#viewing-usage]

Track your resource usage:

1. Click **Billing** in the workspace sidebar
2. View the **Usage Overview** section
3. See progress bars for each limit (Domains, CrUX URLs, Synthetic URLs, RUM Page Views, Web Analytics Events, Indexing Properties, Inspector Tests)

### Usage Warnings [#usage-warnings]

You'll be notified when:

* Approaching limits (75%+ - yellow indicator)
* At or near limits (90%+ - red indicator)

## Best Practices [#best-practices]

### Organize Logically [#organize-logically]

* Group related domains together
* Use consistent naming conventions
* Document workspace purposes

### Plan Appropriately [#plan-appropriately]

* Start with what you need
* Upgrade as you grow
* Downgrade if not using capacity

### Manage Access [#manage-access]

* Only invite necessary team members
* Use appropriate roles
* Remove access when no longer needed

### Monitor Usage [#monitor-usage]

* Check usage regularly
* Plan for growth
* Avoid hitting limits unexpectedly

## Canceling a Workspace Subscription [#canceling-a-workspace-subscription]

To stop using a workspace:

1. Click **Billing** in the workspace sidebar
2. Click **Cancel Subscription**
3. Confirm the cancellation

After canceling:

* Access continues until the end of the billing period
* Data is retained according to the retention policy
* You can resubscribe anytime to restore access

<Callout type="warn">
  If you don't resubscribe within the grace period after your subscription ends, all workspace data will be permanently deleted.
</Callout>

## Transferring Ownership [#transferring-ownership]

If you need to transfer a workspace to another user:

1. Click **Members** in the workspace sidebar
2. Find the member to become owner
3. Click the three-dot menu (⋮)
4. Select **Transfer Ownership**
5. Confirm the transfer

<Callout type="info">
  The new owner must already be a member of the workspace. After transfer, you become an Admin.
</Callout>

## Related [#related]

<Cards>
  <Card title="Team Members" href="/workspace/team-members">
    Manage workspace access
  </Card>

  <Card title="Billing & Plans" href="/workspace/billing">
    Manage subscription
  </Card>
</Cards>