Skip to main content

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
Available on the Standard, Pro, and Enterprise plans. Not available on the Free or Starter plan.

Requirements

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.
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)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"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
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 buttonIf 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
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 customerRight after pressing the button: "Claimed", the coupon code, a "Copy" button, and a "See in your account" linkCustomers 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

Block settings

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

What a customer who already claimed the coupon sees when opening the page again 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.
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 as is.

FAQ

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
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.
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.
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.
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.
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.
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.
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.