---
title: "Checkout extensions (Shopify Plus)"
description: "Offer SureBright shipping and product protection inside Shopify checkout with the Protection Block and Protection Badge"
---

On a Shopify Plus store you can offer protection inside checkout itself, after the shopper has left the cart. You add two blocks in Shopify's checkout editor. They come with the **SureBright - Extended Warranty** app and are listed together in the editor as **SureBright - Product & Shipping Protection**:

<CardGroup cols={2}>
  <Card title="SureBright Protection Block" icon="box">
    A box below the list of cart items that offers **shipping protection** for the whole order with one checkbox.
  </Card>
  <Card title="SureBright Protection Badge" icon="shield">
    A small addition under each cart line: a **Protected** label for covered items and an **Add Warranty** link for eligible items that lets the shopper add a product warranty without leaving checkout.
  </Card>
</CardGroup>

## Requirements

- Your store is on **Shopify Plus**. Shopify shows these checkout blocks on Plus stores only, so the Merchant Portal shows the checkout steps only to Plus stores.
- Your checkout uses **checkout extensibility** (the checkout editor with an **Apps** panel).
- The **SureBright - Extended Warranty** app is installed and your storefront is set up (see [Storefront setup](/shopify/storefront-setup)).

## Add the blocks to your checkout

<Steps>
  <Step title="Open the checkout editor from the Merchant Portal">
    Go to **Settings → Storefront setup**. Under **Protection in checkout**, click **Open checkout editor ↗**. It opens your live checkout on the **Apps** panel. Opening it from this link also switches on the checkout offering in your live SureBright design.
  </Step>
  <Step title="Add both blocks">
    Under **SureBright - Extended Warranty**, click **+** next to **SureBright Protection Block** and **SureBright Protection Badge**.
  </Step>
  <Step title="Include the app in Shop Pay">
    In the checkout behavior controls, turn on **Include app in Shop Pay**.
  </Step>
  <Step title="Save and preview">
    Click **Save**. To check that it works, preview your checkout in the checkout editor. You should see the SureBright protection offer below your cart items.
  </Step>
</Steps>

<Note>
  The Merchant Portal shows no on or off status for checkout, because Shopify does not report where the blocks are placed. Use the checkout editor preview to confirm.
</Note>

<Info>
  The checkout editor preview always shows **sample content**: the Protection Block shows a sample shipping protection price and the badge shows an **Add Warranty** link with sample 1, 2 and 3 year plans on every item. This lets you see the layout before a real shopper reaches checkout. Place a real test checkout to see real prices.
</Info>

## What the shopper sees in checkout

### Protection Block: shipping protection for the order

Once the shopper has entered a shipping address, and shipping protection is available for the items in the cart, a bordered box appears below the cart items:

- A checkbox with the heading **Add Shipping Protection for $X.XX** (in the checkout currency).
- The line **Protects against package damage, loss, theft, & more**, followed by a **see complete coverage** link that opens a coverage pop-up.

Ticking the checkbox adds shipping protection to the order as one line. Unticking removes it. The price updates by itself when the shipping country changes or when products are added or removed. If shipping protection is not available for the cart, nothing is shown.

### Protection Badge: warranty on each cart line

Under each cart line the badge shows what applies to that item:

| Situation | What appears |
| --- | --- |
| Item is eligible for a product warranty and not yet covered | An **Add Warranty** link |
| Item has a product warranty in the cart | A **Protected** label with the product protection icon |
| Shipping protection is on and covers the item | A **Protected** label with the shipping protection icon (plus **Add Warranty** if a product warranty is also available) |
| Both product and shipping protection apply | Both icons with an info tooltip reading **Product warranty and Shipping Protection** |
| Warranty was added in checkout | A trash icon with the tooltip **Remove warranty from cart** on the warranty line |

Clicking **Add Warranty** opens a pop-up for that product:

- The product title and image.
- The plan heading (your configured offering title, or **Add Extended Warranty** by default) and the available terms as selectable options, with a plan pre-selected.
- The coverage bullets for the plan and a **Trusted by 100K+ customers** strip with your store logo and SureBright's.
- **Protect My Purchase** and **No, Thanks** buttons.
- A footer link to the plan's documents.

**Protect My Purchase** adds the chosen warranty to the order with the same quantity as the product. If the shopper later changes the product quantity, the warranty quantity follows. The trash icon removes only warranties added in checkout. A warranty the shopper added earlier, on the product or cart page, is left alone.

## Troubleshooting

<AccordionGroup>
  <Accordion title="I do not see Protection in checkout in the Merchant Portal">
    That card only appears when your store is on a Shopify Plus plan. On other plans, SureBright protection is offered on the product and cart pages instead.
  </Accordion>
  <Accordion title="The blocks are placed but nothing shows in a real checkout">
    - The shipping protection box appears only after a shipping address is entered, and only when shipping protection is available for the items in the cart.
    - The **Add Warranty** link appears only on items that are eligible for a warranty. Items that already have one show **Protected** instead.
    - The checkout editor preview always shows sample content. Test with a real checkout to see real offers.
  </Accordion>
  <Accordion title="The portal says it could not turn on checkout protection">
    The message **We couldn't turn on checkout protection. Open the checkout editor again to try once more.** means the portal could not switch on the checkout offering in your live design. Click **Open checkout editor ↗** again.
  </Accordion>
</AccordionGroup>

## Related

- [Storefront setup](/shopify/storefront-setup): turn SureBright on in your theme first.
- [Bundles](/shopify/bundles): how plans on a bundle behave, including in checkout.

<Accordion title="For developers">
  The two blocks are Shopify checkout UI extensions:

  | Extension | Handle | Target |
  | --- | --- | --- |
  | SureBright Protection Block | `sb-checkout-protection-block` | `purchase.checkout.cart-line-list.render-after` |
  | SureBright Protection Badge | `sb-checkout-protection-badge` | `purchase.checkout.cart-line-item.render-after` |

  Lines added in checkout carry the same properties as lines added on the storefront, listed under [Cart line-item properties](/frontend-widget-integration/frontend-widget-kit/javascript-injection#cart-line-item-properties), with `_sbWarrantySource` set to `CHECKOUT_EXTENSION`. If your own code reads or changes cart lines in checkout, note that:

  - The badge is drawn from the line attributes `_isSBProductProtected`, `_isSBEligibleProduct` and `_isSBShippingProtected`, so lines protected on the storefront before checkout also show as protected.
  - The trash icon is offered only on a warranty line that carries both `_sbQuoteItemId` and `_sbWarrantySource = CHECKOUT_EXTENSION`. Warranties on bundle components (`_isBundleComponentPolicy = "true"`) are removed together.
  - Post-purchase and registration warranties (`_quotePlatform` of `PLATFORM_POST_PURCHASE` or `REGISTRATION_POST_PURCHASE`) are never removed or quantity-matched in checkout, because the product they cover is not in the cart.
  - The order holds one shipping protection line with quantity 1. Extra lines or a higher quantity are corrected.
</Accordion>
