Skip to main content
The Shipping protection block offers an opt-in shipping-protection add-on that shoppers can toggle on in the cart, letting them add protection against damage, loss, or theft during shipping and recording that choice on the order for your fulfillment or claims tooling.

Behavior

  • Adding protection does two things: it adds a real Shopify product line for the protection product, and it sets a _shipping_protected cart attribute to true.
  • That attribute survives checkout and lands on the order as an order note attribute (_shipping_protected), so your fulfillment or claims tools can tell which orders are protected.
  • Shoppers can both add and remove protection with the control, whichever display type you choose.
  • If no usable protection variant exists, the block renders nothing rather than showing a control that would error on click.

Settings

Placement and limits

  • Region: body or bottom.
  • Maximum: 1 per cart state.
  • State: filled cart only.
  • Not added by default. Not locked — you can remove or hide it.

Custom template

Supports a custom template from its Code tab, which replaces this block’s built-in markup with your JSX. These are the props it receives.
format decides which handler applies: handleAdd for button, handleToggle for checkbox and toggle. Wiring the wrong one leaves the control inert for merchants who picked the other format.

Design

Style this block with its Design section in the settings panel. These are per-block overrides that layer on top of your global design and fall back to it when blank.

Text

The Text section in Design lets you control the typography of three elements. Use the Text element picker to switch between them. Title — the protection heading. Also supports a custom font family. Bold and text color are set in the Rich Text Editor above (in the Settings tab), not here. Price — the price line. Bold and text color are set in the Rich Text Editor above. Description — the supporting copy. Bold and text color are set in the Rich Text Editor above.
Clicking a text element directly in the cart preview highlights it and opens its controls in the panel automatically.
What are design settings? Learn more here: Design settings.