Discount List

Display your active discount codes directly at checkout so buyers can find and apply them with one click.

circle-exclamation

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.


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

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.

Pop-up

A link text that opens a modal overlay. Buyers click the link to see all available discounts in a centered dialog.


Step 4: Configure content

Under Content configuration, set the text buyers see at checkout.

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.

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.

circle-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.


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

circle-info

The block placement is flexible β€” you can position it anywhere in your checkout layout.


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)

circle-exclamation

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.

Last updated