ShipScout documentation

Guides, references, and FAQ for installing and configuring ShipScout.

ShipScout is a Shopify app for running shipping experiments. Merchants define variants — each with its own combination of shipping rates, free-shipping thresholds, and customer-facing copy — and ShipScout serves the right variant to each visitor at checkout so the merchant can measure which configuration drives the most revenue.

Visitors are assigned to a variant deterministically, so the same visitor sees the same variant across visits. Experiment participation is gated by a rollout percentage and an optional targeting tree based on URL parameters or visitor country. Merchants who already run their own experimentation platform can opt out of ShipScout's assignment and pass in their own variant choices instead — see Bring your own targeting platform below.

ShipScout's rates appear at Shopify checkout alongside any other configured rates. Because they're served from a registered carrier service named "ShipScout", they're visible to Shopify Delivery Customization Functions through the standard source field on shipping rates. When an order is placed, ShipScout records which variant the customer saw and how much they actually paid for shipping, so per-variant conversion and shipping revenue can be compared in the dashboard.

To keep the rest of your storefront consistent with the variant a visitor is in, ShipScout ships a configurable shipping banner — with templated copy for threshold-based, flat-rate, and always-free shipping scenarios — and a JavaScript SDK (window.shipscout) that exposes the assigned variant and threshold details to your theme. Use these to keep product pages, cart drawers, and FAQ pages in sync with what the visitor will see at checkout.

For anything not covered in these pages, email [email protected]envelope.

In this section

Frequently asked questionschevron-right

Guides

Shipping banner configurationchevron-rightTheme customizations using ShipScout datachevron-rightBring your own targeting platformchevron-rightAdd ShipScout to a shipping zonechevron-rightHeadless storeschevron-rightRecharge (Shopify Checkout)chevron-right

Last updated