> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bouquet-inc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Give a coupon only to customers who press a claim button

> Place a "Get coupon" button on product pages or your home page, so that only customers who press it can use the coupon. Customers who haven't claimed it can't use the code at checkout, even if they know it. Available on the Standard plan or higher.

## What the coupon claim button does

When you add the "Coupon claim button" block to your theme, a logged-in customer can use the coupon only after pressing the button. The claimed coupon also appears in the coupon list on the account page and at checkout.

Customers who haven't pressed the button can't use the code at checkout, even if they know it. Shopify decides whether the code can be used.

When a customer presses the button, a customer tag starting with `dd-claim-` is added to them. Discount Deck creates a customer segment (the claim segment) whose condition is that tag. By setting the discount's eligibility to the claim segment only, only customers who claimed the coupon can use it.

**Ideas for using it**

* **A coupon on the product page** — let customers claim it while they look at the product
* **A coupon on a landing or campaign page** — make it a perk only for people who visit the page
* **A reason to create an account** — claiming requires logging in, so it nudges guests to register
* **Traffic from newsletters and social media** — give the coupon only to people who press the button on the linked page

> [!NOTE]
>
> Available on the Standard, Pro, and Enterprise plans. Not available on the Free or Starter plan.

## Requirements

| Item | Requirement |
| - | - |
| Plan | Standard plan or higher (Standard, Pro, or Enterprise) |
| App permission | The app's new permission (app proxy) must be approved. The first time you open the app on or after November 9, 2026, an approval screen appears |
| Discount type | Code discounts (amount off, Buy X get Y, free shipping). Automatic discounts are not supported |
| Number of codes | The discount must have exactly one code |
| Excluded keywords | The code must not match a keyword in [Coupon codes not shown on the customer account page](https://docs.bouquet-inc.com/en/apps/discount-deck/setup/auto-display-exclusion.md) |
| Number of claim coupons | Up to 20 claim coupons per store whose claim tags have not been removed yet |

If a coupon doesn't meet these requirements, the coupon detail page shows "This coupon can't use the claim button yet" with the reason, and you can't turn it into a claim coupon.

## How to set it up

**1. Approve the app's new permission (first time only)**

The coupon claim button needs a new app permission (app proxy). The first time you open Discount Deck on or after November 9, 2026, an approval screen appears. Approve it.

Until you approve it, the coupon detail page shows "Approve the app's new permission (app proxy)" and you can't distribute coupons with the claim button. Reopen the app to see the approval screen.

**2. Create the discount in Shopify**

In the Shopify admin, go to Discounts and create a code discount. Set the value, code, active dates, one-use-per-customer limit, and so on as usual.

> [!WARNING]
>
> **Keep the start date in the future for now.** At this point the eligibility is "All customers", so if the discount becomes active before you finish, anyone who knows the code can use it. You will change the start date in step 6.

**3. Press "Distribute with a claim button" on the coupon detail page in Discount Deck**

Open the coupon from the app's "Coupon List", and press "**Distribute with a claim button**" in the "**Show the coupon with a claim button**" card.

![The "Show the coupon with a claim button" card on the coupon detail page (not set up)](https://mintcdn.com/bouquet-inc/qmc3ru5_JfavW2OB/images/discount-deck/coupon-claim-button-1.jpg?fit=max\&auto=format\&n=qmc3ru5_JfavW2OB\&q=85\&s=ee1d49c9f4c9b86bb0ee306ab955a86c)

Discount Deck creates the claim segment "Claim coupon / 獲得型クーポン:coupon name(coupon ID)", and the card's status changes to "Waiting for target setup".

![The card after the claim segment is created, showing "Waiting for target setup"](https://mintcdn.com/bouquet-inc/qmc3ru5_JfavW2OB/images/discount-deck/coupon-claim-button-2.jpg?fit=max\&auto=format\&n=qmc3ru5_JfavW2OB\&q=85\&s=7736e4d12808eaf6105317b601160548)

The screenshots on this page show the Shopify admin and the app in Japanese.

**4. Set the discount's eligibility to the claim segment only in Shopify**

Press "**Open the discount in Shopify**" in the card to open the discount in the Shopify admin. Under Eligibility, choose "Specific customer segments", select **only** the claim segment created in step 3, and save.

![The discount's Eligibility set to a customer segment, with only the claim segment selected](https://mintcdn.com/bouquet-inc/DAL9YMFwb-GzyBAJ/images/discount-deck/coupon-claim-button-3.jpg?fit=max\&auto=format\&n=DAL9YMFwb-GzyBAJ\&q=85\&s=96cbb61f6b70fc046004cdc035857de5)

> [!WARNING]
>
> If you also select other segments, customers in those segments can use the coupon without claiming it. Select the claim segment only.

**5. Go back to Discount Deck and press "Confirm"**

Back on the coupon detail page, press "**Confirm**". If the eligibility is set to the claim segment only, the status changes to "Active" and the coupon is treated as displayed on the account page. You don't need to sync it from the coupon list.

The card shows the "**ID for the button**". Press "**Copy ID**" to copy it.

![The card showing "Active" and the ID for the button](https://mintcdn.com/bouquet-inc/qmc3ru5_JfavW2OB/images/discount-deck/coupon-claim-button-4.jpg?fit=max\&auto=format\&n=qmc3ru5_JfavW2OB\&q=85\&s=7be674266b4af15afdac26d37a3d0b7b)

If the eligibility is set differently, a reason such as "The eligibility is not set to a customer segment yet" or "Other segments are also selected" appears and the coupon isn't activated. Check the settings from step 4.

**6. Add the "Coupon claim button" block in the theme editor**

Press "**Add the button in the theme editor**" in the card to open the theme editor with the block added to the product page template. To place it on another page, go to Online Store > Themes > Customize, open the page, and choose "Add block" > "Apps" > "**Coupon claim button**".

Paste the ID you copied in step 5 into the block's "**ID for the button**" setting. Set the heading, description, button text, and colors, then press "Save". See "Block settings" below for each setting.

![The "Coupon claim button" block on the product page in the theme editor, with the ID, heading, and description filled in](https://mintcdn.com/bouquet-inc/DAL9YMFwb-GzyBAJ/images/discount-deck/coupon-claim-button-5.jpg?fit=max\&auto=format\&n=DAL9YMFwb-GzyBAJ\&q=85\&s=8822876f6cd7a9307a48e76dcd9aed5b)

> [!NOTE]
>
> On pages that have no section that accepts blocks, add an "Apps" section first and place the block inside it.

**7. Set the start date and test it**

Change the discount's start date in Shopify to when you want to start distributing the coupon.

Log in to your store as a test customer and press the button. The button changes to "Claimed", and the coupon code, a "Copy" button, and a "See in your account" link appear. A few seconds later, the coupon also appears in the coupon list on the account page and at checkout.

![The "Get coupon" button shown to a logged-in customer](https://mintcdn.com/bouquet-inc/DAL9YMFwb-GzyBAJ/images/discount-deck/coupon-claim-button-7.jpg?fit=max\&auto=format\&n=DAL9YMFwb-GzyBAJ\&q=85\&s=41ab0f90a7767a7edc3b1040685ad748)

![Right after pressing the button: "Claimed", the coupon code, a "Copy" button, and a "See in your account" link](https://mintcdn.com/bouquet-inc/DAL9YMFwb-GzyBAJ/images/discount-deck/coupon-claim-button-8.jpg?fit=max\&auto=format\&n=DAL9YMFwb-GzyBAJ\&q=85\&s=43033b5a4d16043bd528f32ffc941bf9)

Customers who aren't logged in see "Log in to get coupon" instead of the button.

!["Log in to get coupon" shown to a customer who isn't logged in](https://mintcdn.com/bouquet-inc/DAL9YMFwb-GzyBAJ/images/discount-deck/coupon-claim-button-6.jpg?fit=max\&auto=format\&n=DAL9YMFwb-GzyBAJ\&q=85\&s=ce2011f1458e57c45707d8f5b205132f)

## Block settings

| Setting | Details |
| - | - |
| ID for the button | The ID shown on the coupon detail page in Discount Deck. If it contains anything other than digits, the button isn't shown on the storefront |
| Heading | The heading above the button (for example, "10% off coupon") |
| Description | Text shown below the heading |
| Button text | The button text before claiming. Leave blank to use "Get coupon" |
| Text after claiming | The text shown after claiming. Leave blank to use "Claimed" |
| Button text for logged-out customers | The button text for customers who aren't logged in. Leave blank to use "Log in to get coupon" |
| Button background, Button text, Text | Colors of the button and the text |
| Button corner radius | How rounded the button corners are (0 to 30 px) |

While "ID for the button" is empty, a notice asking you to enter the ID appears only in the theme editor, and nothing is shown on the storefront.

## What customers see

| Customer's state | What is shown |
| - | - |
| Not logged in | A "Log in to get coupon" button that opens the login page. After logging in, the customer returns to the page with the button and presses it again |
| Logged in and not claimed yet | A "Get coupon" button |
| Right after pressing the button | "Claimed", the coupon code, a "Copy" button, and a "See in your account" link. A few seconds later the coupon also appears in the list on the account page and at checkout |
| Already claimed and opening the page again | "Claimed" and "See in your account" are shown from the start. The code can be found on the account page |
| The coupon has expired | Pressing the button shows "This coupon is no longer available." |
| Used a one-use-per-customer coupon before claiming it | Pressing the button shows "You've already used this coupon." |
| The claim button is stopped, or the setup has changed | Pressing the button shows "This coupon can't be claimed right now." |

![What a customer who already claimed the coupon sees when opening the page again](https://mintcdn.com/bouquet-inc/DAL9YMFwb-GzyBAJ/images/discount-deck/coupon-claim-button-9.jpg?fit=max\&auto=format\&n=DAL9YMFwb-GzyBAJ\&q=85\&s=d3489cef80ec8d193bd7c1e931414f9b)

The button text follows the store's language (Japanese, English, or Traditional Chinese). If you enter text in the block settings, that text is shown as is.

## Stopping or ending distribution

* **When the coupon expires**: distribution ends automatically with the discount's active dates. Customers who claimed it can no longer use it either
* **Stopping it part way**: press "**Stop the claim button**" on the coupon detail page to stop new claims. Customers who already claimed the coupon can use it until it expires. Press "**Resume the claim button**" to start distributing again
* **When you delete the discount**: the button on the storefront shows "This coupon can't be claimed right now." The next day, the claim tag is removed from customers who claimed it, and the claim segment is deleted

**Automatic removal of claim tags**

Discount Deck removes the customer tag added by the claim button the day after the discount is deleted, or 30 days after the discount expires. The scheduled date is shown on the coupon detail page.

> [!WARNING]
>
> If you want to extend an expired coupon, do so within 30 days after it expires. If you extend it after the claim tags are removed, customers who claimed it can't use it.

Until the claim tags are removed, the coupon counts toward the limit of 20 claim coupons. The current count is shown as "Claim coupons in use" on the coupon detail page.

## Please keep these rules

The claim button relies on three things working together: the customer tag, the claim segment, and the discount's eligibility. Changing any of them by hand lets customers who haven't claimed the coupon use it, or stops customers who claimed it from using it.

* Don't add or remove customer tags starting with `dd-claim-` by hand. Don't use `dd-claim-` for your store's own tags either
* Don't edit the conditions of the claim segment created by Discount Deck, and don't delete it
* Keep the discount's eligibility set to the claim segment only. If the eligibility changes, the coupon detail page shows the warning "The claim button setup has changed"
* Keep the discount's start date in the future until you finish the setup
* Shopify allows up to 250 tags per customer. Customers who have many tags from other apps or from your store's operations can't claim the coupon, and see "Couldn't get the coupon. Please contact the store."
* Don't change the app proxy URL of Discount Deck under Settings > Apps and sales channels in the Shopify admin. If it changes, pressing the button no longer works

## Checking who claimed the coupon

To see the list and number of customers who claimed the coupon, open the customer segment "Claim coupon / 獲得型クーポン:coupon name(coupon ID)" under Customers in the Shopify admin (claim segments created earlier keep the name "獲得型クーポン:coupon name(coupon ID)"). The app doesn't show this list.

To notify customers who claimed the coupon, you can use the Shopify Flow workflow in [Coupon issued notification](https://docs.bouquet-inc.com/en/apps/discount-deck/flows/coupon-issued-notification.md) as is.

## FAQ

> [accordion] A customer claimed the coupon but can't use the code at checkout
>
> Check the following in order.
>
> 1. Does the coupon detail page in Discount Deck show the warning "The claim button setup has changed"? If so, check in Shopify that the discount's eligibility is the claim segment only, and that the claim segment hasn't been edited or deleted
> 2. Is the discount within its active dates?
> 3. For a one-use-per-customer coupon, has the customer already used it?
> 4. Does the customer still have the tag starting with `dd-claim-`? It is removed automatically 30 days after the discount expires

> [accordion] A customer claimed the coupon but it doesn't appear in the list on the account page
>
> It takes a few seconds for the coupon to appear in the list after claiming. Wait a moment and reload the account page.
>
> If the customer already has the maximum number of displayed coupons, coupons with later expiry dates are left out of the list. Even then, the code shown on the button can be used at checkout as usual.

> [accordion] The button doesn't appear on the storefront
>
> Check that the block's "ID for the button" contains the ID shown on the coupon detail page. If it is empty or contains anything other than digits, a notice appears only in the theme editor and nothing is shown on the storefront.
>
> Customers who aren't logged in see "Log in to get coupon" instead of the button.

> [accordion] Pressing the button shows "Couldn't get the coupon"
>
> Check the following.
>
> * Is the status on the coupon detail page in Discount Deck "Active"? Customers can't claim the coupon while it is "Stopped" or "Waiting for target setup"
> * Does the block's "ID for the button" match the coupon's ID?
> * Has the app proxy URL of Discount Deck been changed under Settings > Apps and sales channels in the Shopify admin?
>
> If the message says it's busy, wait a moment and try again.

> [accordion] I can't press "Distribute with a claim button"
>
> The card shows "This coupon can't use the claim button yet" with the reason. See "Requirements" above. For example, a plan below Standard, an unapproved permission, an automatic discount, a discount with more than one code, a code that matches an excluded keyword, or having 20 claim coupons already prevents the coupon from becoming a claim coupon.

> [accordion] I want customers who haven't claimed the coupon to use it too
>
> Don't add other segments or "All customers" to the discount's eligibility. The claim button would stop working correctly. If you need a coupon that can be used without claiming, create it as a separate discount.

> [accordion] What happens to the button after a customer uses a claimed one-use-per-customer coupon?
>
> The button keeps showing "Claimed" and can't be pressed. The used coupon leaves the list on the account page.
>
> If a customer who had already used the coupon before claiming it presses the button, they see "You've already used this coupon." and can't claim it.

> [accordion] Can I limit the claim period or the number of customers?
>
> The claim period is the same as the discount's active dates. To limit it, set the start and end dates of the discount in Shopify.
>
> Limiting the number of customers, such as first come first served, is not supported. To limit the total number of times the coupon can be used, use the discount's usage limit in Shopify.

## Related pages

* [Discount Deck setup](https://docs.bouquet-inc.com/en/apps/discount-deck/setup.md)
* [Coupon issued notification](https://docs.bouquet-inc.com/en/apps/discount-deck/flows/coupon-issued-notification.md)
* [Set coupon codes not shown on the account page](https://docs.bouquet-inc.com/en/apps/discount-deck/setup/auto-display-exclusion.md)
* [Discount Deck FAQ](https://docs.bouquet-inc.com/en/apps/discount-deck/faq.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.