Shipping insurance on Shopify

On Shopify, shipping insurance renders inside checkout via the mulberry-shipping-insurance checkout UI extension. By default it appears as a Package Protection card directly after the cart line items in the order summary. A second location — beside the shipping options on the shipping step — is available when Mulberry enables it for your store.

For what shipping insurance covers, how the premium is calculated, and how claims resolve, see Shipping Insurance.

Orders your team builds manually as draft orders never go through checkout; for those, the Mulberry Package Protection admin block adds the same protection from the draft order page. See Sell via draft orders.

🚧

It must be enabled on both sides

Shipping insurance is switched on in two places: Mulberry enables it on your account (and sets your customer rate), and you enable the block in the Shopify Checkout Editor. If you turn the block on in Shopify but the offer never appears in a test checkout, your Mulberry account is most likely not enabled yet — contact your account manager.

Prerequisites

• The Mulberry Product Protection app is installed on your store. See Install the Mulberry app.
• Shipping insurance is enabled on your Mulberry account by the Mulberry team, including your customer rate. Contact your account manager if you're not sure.
• Your store uses Shopify Checkout Extensibility. The offer is a checkout UI extension and does not render on legacy (Liquid) checkout.

Enable the offer in the Checkout Editor

1. In your Shopify admin, go to Settings → Checkout.
2. Next to the checkout you want to edit, click Customize to open the Checkout Editor.
3. Add the mulberry-shipping-insurance block in each location where you want the offer to appear. Click Add block in the relevant section and select it:
   • After the cart items — under Order summary → Cart, where it anchors below the items in the cart.
   • Beside the shipping options — under Main → Shipping method → Shipping option list, where it anchors below the shipping methods. Add this one only if Mulberry has enabled the shipping-step placement for your store.
   • Each block anchors to its list rather than to a spot you drag it to.
4. With a block selected, set the two toggles in the right-hand panel (each block has its own):
   • Enable shipping insurance (live) — turn this on to show the offer to customers in live checkout. Leave it off to preview the offer in the editor without exposing it to shoppers.
   • Auto-add shipping insurance (auto_add) — when on, the offer is pre-added to the cart so customers start checkout already protected. They can opt out by unchecking the box.
5. Click Save.

You should now see the Package Protection card in the editor preview, beneath the cart items, showing the premium and a checkbox.

👍

Auto-add lifts attach rate

Most retailers see the highest take-up with Auto-add enabled — it gives customers coverage by default while still leaving the choice in their hands.

Confirm it in a test checkout

1. With Enable shipping insurance on, start a checkout with an eligible cart.
2. Confirm the Package Protection card appears after the cart items, showing the Mulberry shield, the premium (e.g. "Package Protection for $5.42"), a short description, a link to the terms, and a checkbox.
3. Toggle the checkbox. The insurance line item is added to or removed from the cart and the order total updates immediately.

🚧

Offer not showing?

The card renders nothing until it has a premium and a variant back from Mulberry. If it stays hidden in a live (non-editor) checkout, check, in order: shipping insurance is enabled on your Mulberry account, this location is active for your store, your customer rate is set, Enable shipping insurance is on, and the cart has at least one eligible product. The editor preview is exempt from the live toggle, so an offer that previews but doesn't show live usually means Enable shipping insurance is still off.

What the customer sees

For an eligible cart, the customer sees a Package Protection card in whichever location is active:

• The Mulberry shield icon and a bold title showing the premium — by default "Package Protection for $5.42".
• A short description ("Protect your order from being damaged, lost, or stolen") with a link to the terms.
• A checkbox to opt in or out.

The title and description above are the defaults; Mulberry can tailor the wording to your store.

Checking the box adds the insurance line item to the cart; unchecking removes it. The order total updates each time, and the premium the customer pays is the amount shown on the card.

Order lifecycle (automatic)

Once shipping insurance is live, Mulberry tracks each insured order through the same webhooks the app already listens to — you don't take any action for these events:

• Recorded — the policy is recorded when the order is placed (orders/create).
• Shipment attached — the tracking number and carrier are sent to the insurer when you fulfill the order in Shopify (fulfillments/create). A fulfillment with no tracking number is skipped, so the insurer always has tracking before a shipment is registered.
• Voided — the policy is voided if the order is cancelled (orders/cancelled).

These webhooks are registered automatically at install. For the full list, see the Webhook catalog.