> 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/bulk-operations/claim-links.md).

# Claim Links

🔗 Share gift cards as single-use links

Claim links let you hand out gift cards without knowing who will get them. Gift Card Factory creates a set of unique, single-use links. You (or a partner) pass each link to one customer in any way you like: a message, a chat, a QR code, a printed flyer. When the customer opens the link and claims it, the gift card is created and its code is shown on the page.

Because the gift card only exists once the link is claimed:

* **Expiry counts from the claim.** A card set to expire 1 month after creation is valid for 1 month from the day the customer claims it, not from the day you created the links.
* **Plan usage counts claimed links only.** Unclaimed links don't use your plan's gift card limit.
* **Unclaimed links cost nothing.** No gift card balance exists until someone claims.

### 💡 **Common Use Cases**

* **Partners and collaborators**: Give a partner a batch of links to pass to their clients, and see which ones were used.
* **Customer service**: Send a goodwill gift card link without creating the card in advance.
* **Events and promotions**: Hand out links or QR codes at an event; only the people who claim get a card.
* **Monthly allocations**: Schedule a repeating run that creates a fresh batch of links every month.

### **📝 Form Fields Explained**

Go to **Bulk Operations → Gift cards → Claim links**.

* **Value**: The initial balance of each gift card.
* **Currency** and **Redemption in**: The same as in [Autogenerate](https://docs.giftcardfactory.app/bulk-operations/autogenerate.md). Shown only when your store has market currencies enabled.
* **Number of links**: How many links to create (1–1000). Each link can be claimed once.
* **Code length**: The number of characters in each gift card code (8–16).
* **Gift card expiry**:
  * **Gift cards never expire**
  * **Gift cards expire relative to claim date**: a duration in days, weeks, months or years from the moment the link is claimed.
  * **Gift cards expire on a specific date**: an exact calendar date.
* **Internal note**: A private note added to every gift card. Only visible to store staff.

#### Claim page

* **Require email address**: On by default. The customer must enter an email address to claim. Untick it to make the email optional: the customer can claim without one and gets the code on the page only. If they do enter an email, it must be valid.
* **Links valid until (optional)**: Unclaimed links stop working after this date (inclusive, in your store's time zone). Leave it empty to keep links valid. Links that were already claimed are not affected.

When a customer enters an email, the gift card is assigned to that customer in Shopify. The customer is found by email or created if they don't exist yet.

#### Emailing the gift card

* **Email the gift card to the customer**: On by default. When the customer enters an email address on the claim page, the gift card is also sent to them. Choose how it's sent: **Shopify Email**, **App Email** (with the **Claim Links** template or a custom template), **Klaviyo** or **Shopify Flow** (fires the **Bulk Operation - Gift Cards** trigger with operation type `GIFT_CARD_CLAIM_LINKS`). See [Sending Customer Notifications](https://docs.giftcardfactory.app/misc/sending-customer-notifications.md).

The code is always shown on the claim page, so customers get their gift card even if the email doesn't arrive or they didn't enter an email.

#### Other options

* **Prefix**: Optional. Adds a fixed prefix (up to 4 letters or digits) to every gift card code.
* **Email the links CSV**: Sends the list of links to one or more email addresses (comma-separated), for example to a partner who will hand them out. The links are always available on the bulk operation page too.

### **▶️ Running the Operation**

* **Create now**: Creates the links immediately.
* **Schedule**: Creates the links at a future date and time, once or repeating on a daily, weekly, monthly or yearly interval (e.g. 50 new links on the 1st of every month). Each upcoming run appears on the Bulk Operations page with a **Scheduled** badge.

### **🔗 Sharing and Tracking Links**

Open the run on the **Bulk Operations** page to see:

* **Links**, **Claimed** and **Unclaimed** counts.
* A table of all links with their status, and for claimed links who claimed them (email) and when.
* **Copy** and **WhatsApp** buttons next to each unclaimed link for quick sharing.
* **Export CSV**: Downloads the full list with statuses at any time. (The CSV download created when the run finishes expires after 3 days; the export on this page doesn't.)

A link looks like `https://your-store.com/apps/gcf/claim?token=kBylp6XsLD2c`. Links are long random tokens, so they can't be guessed.

### **🛍️ What the Customer Sees**

The claim page opens on your store's domain, inside your theme:

1. **Claim form**: a heading, a message with the gift card value, the email field (required or optional) and a **Claim gift card** button. Opening the link alone never claims it, so link previews in chat apps don't use it up.
2. **Gift card claimed**: the gift card code in a box, plus "We've also sent the gift card to your email" when it was emailed, and the expiry date when the card expires.
3. Other states: **Already claimed** (the link was used before), **Expired link** (after **Links valid until**), **Invalid link** and **Error** (the gift card couldn't be created; the link stays unclaimed and can be tried again).

A link can only be claimed once, even if two people open it at the same time.

### **🌍 Texts and Translations**

All claim page texts can be changed and translated in **Settings → Texts & translations → Gift card claim page**. Each state (claim form, gift card claimed, already claimed, expired, invalid, error) has its own texts. You can add a translation per language, or use **Translate with AI**.

Customers see the language that matches their browser. If there's no translation for it, they see your primary language, then the default English texts.

Available placeholders:

* `{{ amount }}`: the gift card value (in the claim form and gift card claimed messages).
* `{{ expires_on }}`: the gift card expiry date (in the expiry note).

### **📊 Reporting and Billing Partners**

Claimed gift cards are linked to their run, so you can use the [Bulk Operation Gift Card Usage](https://docs.giftcardfactory.app/reports/bulk-operation-gift-card-usage.md) report to see how the cards from a batch were redeemed. This is useful when you settle with a partner based on actual use.

### **FAQ**

**Can I cancel a single link?**\
Not yet. Set **Links valid until** to limit how long unclaimed links work.

**Does a claimed link create a gift card if my plan limit is reached?**\
No. The customer sees the error state and the link stays unclaimed, so it can be claimed after you upgrade or your usage resets.

**The customer lost their code. What can they do?**\
Opening the link again shows "already claimed". Find the gift card in Shopify by the customer's email (it's assigned to them) or by the claim date on the bulk operation page.
