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.

Quick Start

Drop the Otter snippet into your site and start running tests.

3 min read

Integration Guides

Platform-specific install guides for Shopify, WordPress, and more.

4 min read

WooCommerce Plugin

Install the official plugin to load the SDK and auto-track the WooCommerce commerce funnel, including revenue.

5 min read

Project Settings

Edit each project's name, URL, setup guide, timezone, and analytics forwarding from a single page.

5 min read

Members & Roles

Invite teammates with one of four roles (owner, admin, member, viewer). Each role controls a precise set of capabilities.

7 min read

Signing In & Account Security

Sign in with a password or a passkey, add passkeys for safer logins, and reset a forgotten password.

4 min read

Billing & Plans

Three plans (Starter, Growth, Scale), 14-day free trial, monthly or annual billing.

6 min read

Excluded IPs

Keep your team's traffic out of test results. Account-wide list of exact IPv4 or IPv6 addresses to mark as bot traffic.

4 min read

Branding

Set a company name, logo, and primary/secondary colors. Customization appears on public shared-report links.

3 min read

Free Tools

A free set of calculators, generators, and guides for planning and checking tests — no account required.

3 min read

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, emulate devices, and watch your goals fire in real time — drafts included, results untouched.

5 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.

Reading Results

Frequentist and Bayesian analysis, confidence thresholds, and key fields.

8 min read

Executive Summary

A plain-English card at the top of every results page that tells you, in one line, whether to ship the change, keep testing, or stop — and why.

5 min read

Experiment Health

An automatic checklist on every results page that tells you whether your numbers are safe to trust yet, and what to fix if they aren't.

5 min read

Segments & Breakdowns

Slice your results down to a group of visitors — like mobile users or email traffic — to spot patterns. Powerful, with one important rule to use them honestly.

5 min read

Comments

Per-test discussion threads. Live updates, every role can post (including viewers), and authors can delete their own comments.

4 min read

Activity Log

Auto-recorded per-test history: lifecycle events, edits, restores, scheduled starts/ends, and stop-condition trips. Live-updates and shows who did what.

4 min read

Chart Annotations

Pin dated notes to the results chart — like a deploy or a campaign — so you (and anyone you share with) understand the bumps and dips later.

4 min read

Shared Reports

Public, read-only links to a test's results page. Optional password, optional expiry, revokable any time.

5 min read

Exporting & Emailing Reports

Download your results as a spreadsheet (CSV) or a PDF, and have a report emailed to anyone on a daily or weekly schedule.

5 min read

Concepts

Variant assignment, statistical significance, and the anti-flicker snippet.

6 min read