Create your first experiment

You can create experiments in two ways:

• Studio no-code UI for business users and quick edits,
• YAML + fx for source-controlled workflows.

Both paths converge on the same governed domain actions.

Option A: Create in Studio

1. Start the hosted API and Studio. See Start the web UI locally.
2. Sign up, verify email, and create an organization.
3. Open /app/{orgSlug}/experiments.
4. Click Create experiment.
5. Fill in basics, sample rate, variants, payload JSON, and metrics.
6. Review the generated spec preview.
7. Click Create draft.

From the experiment detail page you can submit for review, approve, start, pause, resume, conclude, edit, or kill the experiment.

Option B: Author YAML locally

Create experiments/homepage-cta.yaml:

id: homepage-cta
name: Homepage CTA
description: Test whether a more direct CTA improves signup.
sampleRate: 1
variants:
  - key: control
    name: Current CTA
  - key: treatment
    name: New CTA
    payload:
      cta: Start building
metrics:
  - key: signup
    name: Signup
    kind: conversion
    eventName: signup
    isPrimary: true

Validate and apply locally:

fx validate experiments/
fx plan experiments/
fx apply experiments/

Or push to the hosted API:

fx push experiments/ \
  --api-url https://api.example.com \
  --api-key fx_key_... \
  --tenant <orgId>

You can also import the same YAML files in Studio from /app/{orgSlug}/experiments/import.

Lifecycle

Fabric Experiments treats lifecycle changes as actions:

Every action is validated, persisted, and emitted to the audit trail.