Skip to content
Restrict Multi Discount Codes

Limit gift cards at Shopify Plus checkout — how it works

The restrict-gift-cards checkout UI extension limits how many gift cards a customer can apply during checkout. It requires Shopify Plus — checkout UI extensions are not available on standard Shopify plans.

Merchant setting

Section titled “Merchant setting”

In the checkout editor, configure:

Setting Key Type Default
Maximum gift cards allowed max_gift_cards Integer 1

If you leave the setting empty, the extension defaults to 1 gift card.

Customer experience

Section titled “Customer experience”

Within the limit

Section titled “Within the limit”

When the number of applied gift cards is at or below your maximum, customers see an informational banner reminding them of the limit.

Over the limit

Section titled “Over the limit”

When the customer applies more gift cards than allowed:

  1. A critical banner appears with the error message.
  2. Checkout progress is blocked until they remove extra gift cards.
  3. An error appears under the gift card field and a page-level error explains what to do.

This uses Shopify’s buyer journey intercept API with block_progress enabled on the extension.

Using both extensions together

Section titled “Using both extensions together”

Many merchants install both restrict-discount-codes and restrict-gift-cards on the same checkout:

  • Each block has its own maximum setting.
  • Discount code limits and gift card limits are enforced independently.
  • Add both blocks in the Setup guide.
Section titled “Related guides”