> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orderprotection.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Widget Customization

> Create and customize cart and checkout widgets to match your store's brand and checkout experience.

Widgets are the UI components that present Order Protection to your customers at the cart and checkout. You can customize their appearance, content, and behavior to seamlessly match your store's look and feel.

<Note>
  Cart and checkout widget configurations are pre-determined in partnership with the Order Protection development team. Your team will work together with OP to set up the initial widget configuration for your store.
</Note>

<img src="https://mintcdn.com/orderprotectioncom/cqxFqGnfK3ia4602/public/assets/img/education-basecamp/widgets/widget-1-landing-page.png?fit=max&auto=format&n=cqxFqGnfK3ia4602&q=85&s=e4c39ffe39900386c5efcd404bce7066" alt="Widgets landing page showing cart and checkout widgets" width="2808" height="1798" data-path="public/assets/img/education-basecamp/widgets/widget-1-landing-page.png" />

## Widget Types

OrderProtection.com supports two primary widget types:

| Type         | Description                                                                                         |
| ------------ | --------------------------------------------------------------------------------------------------- |
| **Cart**     | Appears on the shopping cart page. Uses a web component that can be embedded anywhere on your site. |
| **Checkout** | Appears on the checkout page. Configured for the Shopify checkout experience.                       |

You can manage all of your widgets from the **Customizations > Widgets** tab. Use the **All**, **Active**, and **Draft** tabs to filter widgets by status.

## Editing a Widget

Click **Edit** on any widget card to open the editor. The editor uses a split-screen layout: the **Customizer sidebar** on the left and a **live widget preview** on the right.

### Checkout Widget Configuration

<img src="https://mintcdn.com/orderprotectioncom/cqxFqGnfK3ia4602/public/assets/img/education-basecamp/widgets/widget-2-ui-config.png?fit=max&auto=format&n=cqxFqGnfK3ia4602&q=85&s=c40b3cf76a3713b02bedeae356d3401c" alt="Checkout widget editor with Customizer sidebar and live preview" width="2800" height="1810" data-path="public/assets/img/education-basecamp/widgets/widget-2-ui-config.png" />

The Customizer tab for checkout widgets includes:

* **Widget Name:** A descriptive name for internal identification (e.g., "Checkout #06").
* **Widget Title Style:** Choose between:
  * **Logo** — Display your store's logo or the Order Protection logo.
  * **Label** — Use a custom text title with typography controls:
    * Title text
    * Label Weight (Bold / Regular)
    * Label Size (inherits Shopify styles)
* **Information Modal:** Toggle to show a "What's this?" link that opens an informational overlay. See [Info Modals](/education-basecamp/customizations/info-modals) to configure these.

### Cart Widget Configuration

<img src="https://mintcdn.com/orderprotectioncom/cqxFqGnfK3ia4602/public/assets/img/education-basecamp/widgets/widget-4-cart-config.png?fit=max&auto=format&n=cqxFqGnfK3ia4602&q=85&s=ec724a78868e14d1ba399e16c33f3893" alt="Cart widget editor with Customizer sidebar and live preview" width="2808" height="1816" data-path="public/assets/img/education-basecamp/widgets/widget-4-cart-config.png" />

Cart widgets include the same title configuration options plus additional styling controls:

* **Label Size:** Set the font size in pixels.
* **Label Color:** Choose a custom color via the color picker.
* **Label Font:** Select from available fonts or upload a custom WOFF font file.

## Advanced Configuration

For **cart widgets only**, the **Advanced Config** tab provides a JSON editor for direct manipulation of the full widget configuration. Import your config by pasting it into the editor, or click **Open Full Screen** for an expanded editing view.

<img src="https://mintcdn.com/orderprotectioncom/cqxFqGnfK3ia4602/public/assets/img/education-basecamp/widgets/widget-5-advanced-config.png?fit=max&auto=format&n=cqxFqGnfK3ia4602&q=85&s=cb1c68708a61108ad0d2c57a902e6093" alt="Advanced Config tab with JSON editor for cart widgets" width="2812" height="1806" data-path="public/assets/img/education-basecamp/widgets/widget-5-advanced-config.png" />

<Warning>
  Advanced configuration is only intended for cart widget setups. Shopify merchants should not use the Advanced Config tab for checkout widgets — use the Customizer tab instead.
</Warning>

## Getting the Widget Code

After publishing your widget, click **Get Code** to view the embed code for your store. The modal provides:

* **Config JSON** — Your widget's configuration object.
* **JavaScript** — A `<script>` tag to include in your site's index file.
* **HTML** — The `<order-protection>` web component tag to place wherever you want the widget to appear.

Use the **Copy Code** buttons to copy each snippet to your clipboard.

<img src="https://mintcdn.com/orderprotectioncom/cqxFqGnfK3ia4602/public/assets/img/education-basecamp/widgets/widget-3-code-scripts.png?fit=max&auto=format&n=cqxFqGnfK3ia4602&q=85&s=37fe85155ca4ac215bbdad73f7286922" alt="Get Code modal showing Config JSON, JavaScript, and HTML snippets" width="2808" height="1804" data-path="public/assets/img/education-basecamp/widgets/widget-3-code-scripts.png" />

<Tip>
  Code scripts are also available if you're modifying cart or checkout themes directly via a code repository.
</Tip>

## Publishing and Drafts

| Action           | Description                                                                 |
| ---------------- | --------------------------------------------------------------------------- |
| **Save & Draft** | Saves your changes as a draft. The widget will not be visible to customers. |
| **Publish**      | Pushes your widget live. Customers will see the updated widget immediately. |
| **Republish**    | Available after making changes to a published widget. Pushes updates live.  |

You can manage multiple widgets (e.g., different designs for cart vs. checkout) and switch between Active and Draft statuses at any time.
