> For the complete documentation index, see [llms.txt](https://docs.giftcardfactory.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giftcardfactory.app/extensions/checkout-gift-cards.md).

# Checkout Gift Cards

Remind logged-in customers of their gift cards at checkout — last 4 characters, expiry date, and remaining balance, with an optional resend button.

Checkout Gift Cards is a **checkout block** that lists the logged-in customer's gift cards right where they're about to pay. Customers often forget they have a gift card — showing the cards with their remaining balance next to Shopify's gift card field turns that forgotten value into a completed purchase.

For each card the block shows the **last 4 characters** of the code, the **expiry date**, and the **current balance**. Cards already redeemed in the current checkout get an **Applied** badge, and an optional **Resend** button lets the customer email themselves the gift card again if they can't find the code.

{% hint style="warning" %}
**Prerequisites.** The block is available in Shopify's checkout editor (checkout extensibility). Customers must be **logged in** for their gift cards to be identified — guests see nothing, or a sign-in hint if you enable it.
{% endhint %}

## Which gift cards does a customer see?

The same rules as [Customer Account Gift Cards](/extensions/customer-account-gift-cards.md) apply — a card appears when it is linked to the logged-in customer in Shopify:

* **Purchased** — the card's *customer* field points at them (they bought it while logged in, or you issued it to them with Gift Card Factory).
* **Received as a gift** — the card's *recipient* field points at them (the buyer filled in the recipient form on your gift card product).

By default only **active cards with a remaining balance** are listed, since those are the ones worth using at checkout. Turn on *Include used, expired and deactivated cards* to show everything, with a status badge on each card that isn't active.

Gift card **codes are never shown** — only the last 4 characters. To redeem a card, the customer enters the full code in Shopify's gift card field as usual.

## Customer actions

### Resend by email

Re-sends the standard Shopify gift card notification for that card, so a customer who lost the original email can get the full code without leaving checkout. Available for active cards only, and only ever delivered to the customer's own linked role (purchaser or recipient). The outcome is shown under the card.

### Applied badge

When a customer redeems a gift card in the checkout, the matching card in the list is marked **Applied**. This makes it obvious which cards still have value to use in this order.

## Setup

1. Open the checkout editor: **Settings → Checkout → Customize**.
2. Make sure the **Checkout** page is selected in the top dropdown.
3. Click **Add app block** and choose **Customer Gift Cards**.
4. Position it — we recommend placing it next to the **Payment** section, close to Shopify's gift card field — adjust the settings, and **Save**.

{% hint style="info" %}
While setting up, keep **Hide when empty** off so you can see the block in the editor preview even for customers without gift cards.
{% endhint %}

## Settings

Everything is visible by default — enable a toggle only to hide that element.

| Setting                                         | Description                                                                                                                      |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| **Heading**                                     | Custom heading for the block. Leave empty to use the translated default ("Gift cards").                                          |
| **Include used, expired and deactivated cards** | Off by default: only active cards with an available balance are listed. On: all linked cards are shown with a status badge.      |
| **Hide purchased gift cards**                   | Hide cards where the logged-in customer is the assigned customer (e.g. the purchaser).                                           |
| **Hide received gift cards**                    | Hide cards where the logged-in customer is the recipient.                                                                        |
| **Hide resend button**                          | Remove the *Resend* button next to each active card.                                                                             |
| **Hide expiry date**                            | Hide the expiry date shown under each card.                                                                                      |
| **Maximum cards to show**                       | Limit how many cards are listed. Leave empty to show all; when limited, the block mentions how many more cards the customer has. |
| **Show sign-in hint to guests**                 | Show "Sign in to see your gift cards" to buyers who aren't logged in. Off by default: guests see nothing.                        |
| **Hide when empty**                             | Hide the whole block for customers who have no gift cards to show. Off by default so you can see the block while setting it up.  |

The block is translated into the same languages as the app's other customer-facing extensions and follows the buyer's checkout language.

## FAQ

**Can the block apply a gift card to the order automatically?**\
No. Shopify only reveals a gift card's full code at the moment it is created and Gift Card Factory never stores codes, so the block can't redeem a card on the customer's behalf. It shows the last 4 characters and balance; the customer enters the code in Shopify's gift card field.

**A customer says their gift card doesn't show up.**\
Either they aren't logged in, or the card isn't linked to their customer record — for example, it was sent to a different email address than the one they log in with, or it was bought at a guest checkout without recipient details. The card still works normally with its code.

**Does it work with express checkouts (Shop Pay, Apple Pay, Google Pay)?**\
The block renders in the standard checkout. Accelerated checkout sheets don't show app blocks.

**Does it show store credit?**\
No — store credit is applied automatically by Shopify for logged-in customers. The block only lists gift cards. See [Gift Cards vs Discount Codes vs Store Credit](/comparison.md) for the difference.