Experiment Statuses (Reference)
This page is the canonical list of experiment (campaign) lifecycle states. A status is a labeled stage in a process—like “draft” vs “published” on a blog. In CROForge each status is a number in code (enum values 0–5) so the frontend, API, and Smart Code agree. Only Running is included in live Smart Code.
Source: EXPERIMENT_STATUS / EXPERIMENT_STATUS_COLOR in lib/enums.ts. Doc ID: ref.statuses. Audience: both (product users and developers).
Words used on this page
| Word | Everyday meaning | Meaning in CROForge |
|---|---|---|
| Enum | A labeled list of allowed values (no magic loose numbers in UI copy). | EXPERIMENT_STATUS in lib/enums.ts: Draft 0, Running 1, Paused 2, Completed 3, Trash 4, Archived 5. |
| Draft | A work in progress, not shown to the public. | Enum 0. UI color key secondary. Not in live Smart Code. |
| Running | Live; currently in front of real visitors. | Enum 1. UI color key success. Yes — included in live Smart Code. |
| Paused | Temporarily stopped; you can start it again. | Enum 2. UI color key warning. Not in live Smart Code. |
| Completed | Finished on purpose; the test is over. | Enum 3. UI color key success. Not in live Smart Code. |
| Trash | The recycle bin—removed from normal lists, not necessarily gone forever. | Enum 4. UI color key destructive. Not in live Smart Code. |
| Archived | Filed away for history, not active work. | Enum 5. UI color key info. Not in live Smart Code. |
| UI color key | A token that tells the design system which badge color to use. | EXPERIMENT_STATUS_COLOR: secondary, success, warning, destructive, info. |
| Live Smart Code | Whether the compiled init.js still evaluates this experiment for real visitors. | Only Running (1) is Yes. All other statuses are No. |
Screenshot filename
Suggested screenshot filename: experiment-statuses.png (same asset as the lifecycle guide). Capture the campaign list with status badges. Insert the real image from the WordPress Media Library in place of this note.
Status table
Treat this table as the source of truth for numeric values. Product copy should use the Name column; APIs and Smart Code use the enum value.
| Status | Enum value | UI color key | Live Smart Code? |
|---|---|---|---|
| Draft | 0 | secondary | No |
| Running | 1 | success | Yes |
| Paused | 2 | warning | No |
| Completed | 3 | success | No |
| Trash | 4 | destructive | No |
| Archived | 5 | info | No |
Code mapping: EXPERIMENT_STATUS.DRAFT = 0, RUNNING = 1, PAUSED = 2, COMPLETED = 3, TRASH = 4, ARCHIVED = 5. Color map: Draft → secondary, Running → success, Paused → warning, Archived → info, Trash → destructive, Completed → success.
