# Discount List Display your active discount codes directly at checkout so buyers can find and apply them with one click. {% hint style="warning" %} **Shopify Plus required.** This widget uses Checkout UI Extensions, which require a Shopify Plus plan. {% endhint %} *** ## What it does Discount List shows your active Shopify discount codes to buyers at checkout. Instead of remembering or searching for codes, buyers see available discounts listed right on the checkout page and can apply them instantly. The widget automatically validates each discount against the buyer's current cart — only showing codes that actually work for their order. *** ## Step 1: Go to Extra Widgets In the app sidebar, click **Extra Widgets**. Find the **Discount List** card and click **Manage**. {% embed url="" %} *** ## Step 2: Create a widget Click **Create widget** (top right). The editor opens with two areas: * **Left (main)** — Widget layout, Content configuration, Discount list configuration * **Right (sidebar)** — Status, Widget name, App block status, Preview {% embed url="" %} | Field | Description | | --------------- | --------------------------------------------------------------------------------------------------------------------------- | | **Status** | Toggle between **Active** (green) and **Expired**. Only active widgets show at checkout. | | **Widget name** | Required. Internal name for your reference — not shown to buyers. | | **App block** | Shows **"Added"** (green) if the Discount List block is in your checkout theme. Click **"Go to theme settings"** to add it. | | **Preview** | Live preview — updates in real time as you change settings. | *** ## Step 3: Choose a layout Under **Widget layout**, click one of the two preview cards to select how the discount list appears at checkout. ### Embedded widget (default) A collapsible list that appears inline below the discount code input. Buyers click the title to expand and see available discounts. {% embed url="" %} ### Pop-up A link text that opens a modal overlay. Buyers click the link to see all available discounts in a centered dialog. {% embed url="" %} *** ## Step 4: Configure content Under **Content configuration**, set the text buyers see at checkout. {% embed url="" %} | Setting | Default | Description | | ---------------- | --------------------- | ------------------------------------------------------------------------------------------ | | **Title** | "Available discounts" | The clickable text label. For embedded: the collapsible header. For pop-up: the link text. | | **Button label** | "Apply" | Text on the apply button next to each discount code. | Both fields are required. *** ## Step 5: Configure discount sorting Under **Discount list configuration**, choose whether to sort discounts by savings. {% embed url="" %} | Setting | Default | Description | | ----------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------- | | **Enable sorting discounts by highest savings** | Off | When on, discounts are sorted by estimated savings (highest first). When off, discounts appear in default order. | {% hint style="info" %} **How savings are calculated:** The widget estimates savings based on the buyer's current cart — percentage discounts calculate against eligible items, fixed amount discounts compare against the subtotal. The highest-value discount appears first. {% endhint %} *** ## Step 6: Save Click **Save** in the top bar. The widget is live when: * Status is **Active** * The Discount List app block is **Added** to your checkout theme *** ## Add the block to your checkout theme If the sidebar shows **"Not added"** for the app block: 1. Click **"Go to theme settings"** 2. In the Shopify Theme Editor, select **Checkout** page 3. Click **Add block** → find **AOV.AI — Discount List** 4. Drag the block to your preferred position (default: under the order summary) 5. Click **Save** {% hint style="info" %} The block placement is flexible — you can position it anywhere in your checkout layout. {% endhint %} *** ## Which discounts are shown The widget automatically fetches your active Shopify discount codes and validates each one against the buyer's cart. A discount is shown only if it passes **all** of these checks: | # | Check | What it means | | - | ------------------- | --------------------------------------------------------------- | | 1 | Supported type | Only **Basic** and **Buy X Get Y** discount codes are supported | | 2 | Not expired | The discount's end date hasn't passed | | 3 | Usage limit | The discount hasn't reached its maximum number of uses | | 4 | Not already applied | The buyer hasn't already applied this code | | 5 | Minimum requirement | The cart meets the minimum subtotal or quantity | | 6 | Customer eligible | The buyer belongs to the required customer segment (if any) | | 7 | Applicable to cart | The discount applies to products/collections in the cart | | 8 | Can combine | The discount doesn't conflict with already-applied discounts | * **Maximum 5 discounts** are shown at a time * If no discounts are valid, the widget **hides completely** — no empty state is shown * The widget **re-validates** whenever the cart changes (items added/removed, codes applied) {% hint style="warning" %} **Not supported:** Automatic discounts (discounts without a code), free shipping discount codes, and "Amount off products" discount codes with specific product/collection targeting that doesn't match the cart. {% endhint %} *** ## Buyer experience at checkout ### Embedded widget layout The discount list appears inline below the discount code input: 1. Buyer sees a clickable title (e.g., "Available discounts") 2. Clicking expands the list to show discount cards 3. Each card shows: * Discount icon + **code** (bold) * **Apply** button on the right * **Summary** — description of the discount (e.g., "20% off entire order - Minimum purchase of 4 items") * **Expiry date** — in subdued text (e.g., "Expires on Feb 14, 2026" or "No expiration date") 4. Clicking **Apply** adds the code to the order (button shows a spinner while applying) 5. The list collapses when clicked again ### Pop-up layout 1. Buyer sees a clickable link (e.g., "Available discounts") 2. Clicking opens a modal overlay with discount cards 3. Same card format as embedded (code, apply button, summary, expiry) 4. Clicking **Apply** adds the code and **automatically closes the modal** 5. Close button (X) in the top corner *** ## Validation | Rule | Error message | | --------------------- | -------------------------- | | Widget name is empty | "Widget name is required" | | Title is empty | "Title is required" | | Button label is empty | "Button label is required" | *** ## Tips * **Keep titles short** — "Available discounts" or "Your discounts" works well. Buyers need to understand what the link does at a glance. * **Sort by savings** if you have multiple active discounts — buyers will see the best deal first, improving perceived value. * **Review your active discounts** — the widget shows ALL valid discount codes. If you have internal or affiliate codes that shouldn't be public, deactivate them in Shopify or set customer eligibility restrictions. * **Test at checkout** — create a test order to see how your discounts appear. The admin preview shows sample data, but the checkout shows real discounts. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.aov.ai/aov.ai-checkout-upsell/extra-widgets/discount-list.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.