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 support@shipscout.app.

In this section

Frequently asked questions

Guides

Shipping banner configurationTheme customizations using ShipScout dataBring your own targeting platformAdd ShipScout to a shipping zoneHeadless storesRecharge (Shopify Checkout)

Last updated