Documentation

Everything you need to ship better experiments

Guides, references, and worked examples for installing Otter, building tests, reading results, and integrating from your stack.

Getting Started

Get set up: install Otter, invite your team, secure your account, and manage billing.

Building Tests

Design experiments — pick a test type, choose pages, and define goals.

Creating a Test

Test types, the six-step wizard, and how variants are configured.

7 min read

URL Matching

Choose which pages each test runs on — exact, simple, contains, wildcard, regex.

5 min read

Visual Editor

Build variants by editing your live site in a popup window. Apply changes to one element or all matching instances. 15-minute signed sessions, scoped to your verified project's domain.

7 min read

Preview Bar

A bottom toolbar that lets you view your live site as any test → variant — drafts included — without touching results.

4 min read

Goals

Pageview, click, custom event, revenue, and GA4 goal types.

6 min read

Revenue & Currency

Track money made by each version and report it in a single currency — Otter converts other currencies for you so the comparison is fair.

5 min read

GA4 Integration

Connect a GA4 property so you can use existing GA4 events as goals. OAuth flow, property selection, sync schedule, and limits.

6 min read

Targeting

Filter who sees a test with AND/OR rules over 18 fields: location, device, traffic source, UTM tags, time, cookies, custom properties.

8 min read

Test Lifecycle

Draft, running, paused, completed, archived — what each state means, which transitions are allowed, and when you can edit, delete, duplicate, or restore.

6 min read

Stop Conditions

Configure a test to auto-complete when it hits a visitor count, conversion count, or when a variant wins. Hands-off lifecycle management.

5 min read

Scheduled Start & End

Auto-launch a draft at a future time. Auto-complete a running test at a future time. Both checked every 5 minutes; auto-start requires the test to be launch-ready.

4 min read

Version History

Every meaningful draft edit creates a snapshot with an auto-generated summary. Restore any prior version into the current draft.

5 min read

Custom CSS & JavaScript

Drop bespoke CSS and JS into a test or variant when the visual editor isn't enough. Variant-scoped runs only for that variant; test-wide runs for everyone in the test (including the control).

6 min read

Analyzing Results

Read the results page with confidence and understand the math behind it.