Multi-Workspace Accounts: How Accounts Work Across Multiple Workspaces

Multi-workspace accounts let you manage multiple RapidPro workspaces under a single billing account. This setup is useful for organizations running separate programs (countries, projects, clients) while keeping each workspace operationally separate. Billing and usage are consolidated into one invoice, and active contact usage is pooled across linked workspaces (with potential volume discounts at higher usage tiers). Child workspaces are created from the primary account, and you can switch between workspaces from the workspace switcher without logging out. To enable a multi-workspace/reseller plan or discuss consolidation of existing workspaces, you must contact RapidPro support.

Quick Setup Checklist

Use this checklist to understand how multi-workspace billing works and how to manage child workspaces safely.

  1. Confirm what a multi-workspace account is and when to use it.
  2. Understand primary vs child workspaces and how billing is structured.
  3. Review how contact usage pooling and discounts work.
  4. Create a child workspace from the primary account.
  5. Switch between workspaces and avoid common navigation issues.
1
Understand multi-workspace accounts

Multi-workspace accounts allow you to manage multiple RapidPro workspaces under a single billing account. This setup is ideal for organizations running programs across multiple countries or projects, as well as agencies or resellers managing workspaces for different clients.

All usage and charges are consolidated into one invoice, while workspaces remain operationally separate.

[CAPTURE: Account or Billing page showing multiple workspaces under one account.]

2
Understand primary vs child workspaces

Primary account

  • Acts as the billing and management account
  • Enables the creation of additional workspaces
  • Does not include the standard 1,000 free contacts

[CAPTURE: Billing page highlighting the primary workspace.]

Child workspaces

  • Created and managed from the primary account
  • Useful for separate programs, regions, or clients
  • Billed per workspace under the same account

[CAPTURE: Workspaces list showing multiple child workspaces.]

3
Review contact usage pooling and discounts

On multi-workspace accounts, active contact usage is pooled across all linked workspaces. This means usage is monitored and billed at the account level (not per workspace).

If combined active usage exceeds certain thresholds (for example, 100,000 contacts), a discount may be available depending on your plan and provider review process.

[CAPTURE: Usage or billing metrics panel showing aggregated contact counts.]

4
Create a child workspace

To create a new child workspace:

  1. Go to Workspace Settings.
  2. Click Workspaces in the left-hand menu (this option appears only on multi-workspace/reseller plans).
  3. Click New.
  4. Enter a name and create the workspace.

[CAPTURE: Workspace Settings page with “Workspaces” selected.]

[CAPTURE: “New Workspace” creation dialog.]

After creation, you’ll see a list of all workspaces linked to your account.

5
Navigate between workspaces

To switch workspaces without logging out:

  • Click your profile initials in the top-left corner.
  • Select the workspace you want to access from the dropdown.

If you open a link to a flow, contact, or message that belongs to another workspace, RapidPro may prompt you to switch automatically.

[CAPTURE: Workspace switcher dropdown showing multiple workspaces.]

Common Issues & Fixes

I don’t see the Workspaces option in Settings

Cause: Your account is not on a multi-workspace plan.

Fix: Contact support to enable multi-workspace billing.

I expected contact limits per workspace

Explanation: Contact usage is shared across all linked workspaces.

Fix: Monitor usage at the account level (billing/usage page), not per workspace.

I want to merge existing workspaces

Explanation: Workspaces cannot be merged automatically.

Fix: Export and import flows and contacts manually to consolidate content into a single workspace.

Branding applies to all workspaces

Explanation: Branding (logo, colors, custom domain) is typically configured at the account level.

Fix: Confirm branding requirements with support before enabling custom branding.