For the complete documentation index, see llms.txt. This page is also available as Markdown.

Customer Account Gift Cards

Give logged-in customers a self-service view of their gift cards — with resend, transaction history, and conversion to store credit.

Customer Account Gift Cards brings your customers' gift cards into the new customer accounts experience. After logging in, a customer sees every gift card linked to them — cards they purchased and cards they received as a gift — together with the balance, status, and expiry date. From there they can resend a gift card email to themselves, review a card's transaction history, or convert a card's remaining balance into store credit on their account.

Watch the demos: Gift Cards page · Gift Cards block. Both are listed under Customer accounts on the Extensions page in the app (see The Extensions page).

The feature consists of two extensions that share the same data and settings philosophy:

  • Gift Cards page — a full page in customer accounts, linked from the account menu. The complete view: all cards with details, actions, and per-card transaction history.

  • Gift Cards block — a compact widget for the Profile page showing each card with its balance and a quick actions menu.

Which gift cards does a customer see?

A gift card appears in a customer's account when it is linked to them in Shopify:

  • Purchased — the card's customer field points at them (for example, they bought the card 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. Shopify sets the recipient when the buyer fills in the recipient form on your gift card product ("I want to send this as a gift").

Recipients are matched by their customer record, so the recipient sees the card when they log in with the same email address the card was sent to. Enabling the recipient form on your gift card product is what makes gifting work end to end.

Gift card codes are never shown in customer accounts — only the last 4 characters. The full code stays in the gift card email.

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 code again. Available for active cards only, and only ever delivered to the customer's own linked role (purchaser or recipient).

Transaction history

On the Gift Cards page, each card's menu includes View history — a modal listing the card's credits and redemptions with the date, amount, and the balance after each transaction.

Convert to store credit

Turns the card's remaining balance into store credit on the logged-in customer's account — in the same currency the card was issued in. The customer confirms in a dialog; after conversion the gift card balance is set to zero (and, if you enable it, the card is deactivated), so the value can't be spent twice. Store credit then applies at checkout the standard Shopify way whenever the customer is logged in.

You control two aspects of the conversion in the extension settings:

  • Store credit expiry — never, the gift card's own expiry date, or a fixed number of days after conversion (e.g. 1095 for 3 years where consumer law requires it). The expiry date is shown to the customer in the confirmation.

  • Deactivate gift card after conversion — off by default, in which case the card simply shows as Redeemed with a zero balance. Turn it on to also deactivate the card, which then shows as Deactivated.

Setup

Add the Gift Cards page

Adding the page is a two-part step: the page itself must be added to your store in the checkout and accounts editor, and a menu item must point at it. A menu link alone is not enough — customers would see a "There's a problem loading this page" error.

  1. Open the checkout and accounts editor: Settings → Checkout → Customize, then switch the top dropdown to Customer accounts.

  2. Add the Gift Cards app page.

    Shopify then prompts you to also add it to the account menu — accept the prompt, or add the link yourself under Content → Menus (pick the Gift Cards app page as the link target).

  3. Save / publish. The link appears in the customer account navigation next to Orders and Profile.

Add the Gift Cards block to the Profile page

  1. Open the checkout and accounts editor: Settings → Checkout → Customize, then switch the top dropdown to Customer accounts.

  2. Select the Profile page.

  3. Click Add app block and choose Gift Cards Block.

  4. Position it, adjust the settings, and Save.

Settings

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

Gift Cards block

Setting
Description

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 action

Remove Resend from the card actions menu.

Hide convert to store credit

Remove Convert to store credit from the card actions menu.

Converted store credit expiry

Never, Use gift card expiry (never if the card has no expiry date), or Days after conversion.

Number of days

How long the converted credit stays valid — only applies with the Days after conversion option. 1095 = 3 years.

Deactivate gift card after conversion

Off: the card's balance is set to zero and it shows as Redeemed. On: the card is also deactivated and shows as Deactivated.

Hide when empty

Hide the whole block for customers who have no gift cards. Off by default so you can see the block while setting it up.

Gift Cards page

Setting
Description

Hide purchased gift cards

Hide cards where the logged-in customer is the assigned customer.

Hide received gift cards

Hide cards where the logged-in customer is the recipient.

Hide convert to store credit

Remove Convert to store credit from the card actions menu.

Converted store credit expiry

Never, Use gift card expiry (never if the card has no expiry date), or Days after conversion.

Number of days

How long the converted credit stays valid — only applies with the Days after conversion option. 1095 = 3 years.

Deactivate gift card after conversion

Off: the card's balance is set to zero and it shows as Redeemed. On: the card is also deactivated and shows as Deactivated.

Settings are configured per extension — if you use both the page and the block, set the expiry and deactivation options on both so conversions behave the same everywhere.

FAQ

Does this change the gift card purchase flow? No. Cards are bought and delivered exactly as before — Shopify still sends the gift card email. These extensions only add a self-service view for cards already linked to the customer.

A customer says their gift card doesn't show up. The card is most likely not 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; it just won't be listed.

What do the statuses mean? Active — usable balance remaining. Redeemed — the balance has been fully used (including after a conversion with deactivation off). Deactivated — the card was deactivated. Expired — past its expiry date.

What happens if a converted card was only partially used? Only the remaining balance is converted. The card's transaction history (and your reports) keep the full record.

Which currency does the store credit use? Always the gift card's own currency. A USD card becomes USD store credit, a PLN card becomes PLN store credit — no conversion is applied.

Last updated