Shipping protection widgets
The storefront surfaces that offer shipping protection: the cart widget and its layouts, the coverage pop-ups, the in-cart line treatment, and the checkout block, with how each is enabled.
Shipping protection is a separate opt-in from product protection: one small fee that covers the whole shipment against loss, damage and theft in transit. What it covers, how it is priced and what happens when an order ships is described in Shipping protection. This page is about what the shopper sees on the storefront and how those surfaces are switched on.
Shipping protection is enabled per store by SureBright. Once it is on, the SDK quotes the cart, shows the offer in the cart, and keeps exactly one shipping-protection line in step with what is in the cart. Nothing is needed from the theme beyond an anchor SureBright configures.
The cart widget#
The widget (sb-shipping-insurance) is mounted on the cart page and in the cart drawer at the anchor configured for your store, usually just above the Checkout button. It appears only when SureBright returns a shipping quote for the eligible items in the cart; a cart with nothing eligible shows nothing.
Two interaction modes are available:
Ticking the box or pressing the button adds the shipping-protection line; doing it again removes it. The price is recalculated whenever the cart changes. The texts above are SureBright's defaults and can be changed per store, as can the icon colour theme and whether co-branding is shown.
Stores still on SureBright's earlier widget build see one of three equivalent templates: a card with a shipping illustration, checkbox and info icon; a compact checkbox row; or the compact row placed inside a cart table row. Which one a store uses is set by SureBright.
The coverage pop-up#
see complete coverage opens a pop-up with the coverage list for the quote. Two layouts exist, chosen per store:
Choosing Protect my purchase in the pop-up adds the line exactly as the widget does. The headline, headings, button labels and footer text are configurable per store by SureBright.
The line in the cart#
When shipping protection is in the cart it is a line item named Shipping Protection Powered by SureBright, a product SureBright created in your catalogue. The SDK relabels that row with a branded card (sb-si-details) showing the title, description and coverage link, and locks the row's quantity controls while leaving the remove control working. The line always has quantity 1; if a theme or app changes it, the SDK sets it back.
The SDK re-evaluates the line whenever the cart changes:
The line carries _sbQuotePlatform = PLATFORM_SHIPPING_INSURANCE, _sbQuoteId and _sbAddedAt; these must reach the order unchanged. See Cart line-item properties.
When the cart line badges are enabled for your store, products covered by shipping protection also get a shipping-protected badge on their own cart rows.
In checkout#
Shopify's checkout does not run storefront scripts. On Shopify Plus the offer continues inside checkout through the SureBright Protection Block, a checkout UI extension that ships with the app: a checkbox below the cart lines reading Add Shipping Protection for $X, re-quoted when the shipping address changes. It is placed from the checkout editor and documented in Checkout extensions. On other plans the cart widget is the last place the shopper can opt in.
Enabling it#
Ask SureBright to turn on shipping protection
Shipping protection is a store-level setting SureBright enables. It needs the shipping-protection product in your catalogue, which SureBright creates. Shipments are covered to United States addresses only; see Orders that cannot be covered.
Agree the placement
Tell SureBright where in your cart page and drawer the widget should sit. The anchor is a CSS selector kept in your store's configuration, not in your theme code.
Pick the layout
Checkbox or button, standard or cart-items pop-up, and any copy changes. All of this is configured by SureBright.
Shopify Plus: add the checkout block
Follow Checkout extensions to place the Protection Block.
For developers#
The widget dispatches sb-widget-event with SHIPPING_INSURANCE_TOGGLED, SHIPPING_INSURANCE_DIALOG_OPEN, SI_COVERAGE_LINK_CLICKED, SI_PROTECT_CLICKED and SI_DECLINE_CLICKED, and window.SureBright.onSelectionChange reports changes with source: "shippingInsurance" and a null product. Both are described in the JavaScript API Reference. With ?sb_debug the orchestrator logs under [SB] [SHIPPING].