Help Center/Admin Operations/How to switch the platform between Zero-State and Simulation mode
Admin Operations•Last updated: 2026-10-20•3 min read

How to switch the platform between Zero-State and Simulation mode

The "Platform State Control" widget on the Command Center toggles whether demo members, sample downlines and test metrics are visible or suppressed.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Find the widget

On /admin, locate the card titled "Platform State Control". Its badge says either "Zero-State Mode Active" or "Simulation Mode Active".

2

Read the description

In Zero-State the card explains that synthetic members, fake downline trees and hardcoded fallback metrics are suppressed and only real database entries count. In Simulation mode it explains that demo members and sample downlines are visible.

3

Click the toggle button

Click "Enable Zero-State Mode" (when in Simulation) or "Switch to Simulation Mode" (when in Zero-State). The button posts the new state to /api/admin/system/zero-state.

4

Wait for the confirmation

A green message confirms the new mode, then the page reloads after about a second so every table and chart reflects it. A red message appears if the API refuses (for example "Failed to toggle system mode. Check admin permissions.").

Expected Operational Outcome

The badge shows the new mode and, after the automatic reload, admin tables show or hide demo data accordingly.

Troubleshooting & Failure Modes

Symptom: "Failed to toggle system mode. Check admin permissions."
Likely Cause: The zero-state API only accepts administrator principals and answered 403.
Resolution: Sign in with an administrator account and retry.
Symptom: "The control plane service could not be reached."
Likely Cause: The request failed at network level.
Resolution: Check your connection and click the button again.

Was this guide helpful?

Help us refine our platform documentation