Skip to main content

Setting up Gift With Purchase Unlock

Offer shoppers a free product, subscription gift, or coupon at checkout — with custom messaging and styling

The Gift Unlock extension shows shoppers a gift offer during checkout — a free product, a subscription item, or a coupon — to push them through to completion. Configure everything in PDQ across three tabs (Settings, Gift Message, Offer), then connect it to your Shopify checkout via a token.

Where to find it

Go to Convert > Extensions in your PDQ dashboard. Click + New and select Gift Unlock. The editor opens with three tabs: Settings, Gift Message, and Offer. Configure all three before activating in Shopify.

Settings tab

General

  • Internal Name — your team's reference, hidden from customers.

  • Internal Description — optional internal note.

Component Placement

  • Standalone — renders as its own block in checkout, not tied to a shipping method.

  • Inside Shipping Method — nested within a specific shipping method. If you pick this, define which method it shows up for in your Shopify Online Store Editor.

Offer Type — the kind of gift. This selection changes the Offer tab significantly.

  • Product — a specific product from your catalog.

  • Selling Plan Product — a product tied to a selling plan (e.g. a subscription item).

  • Coupon — a discount code.

Auto-Apply Gift If Product Is Free — visible when Offer Type is Product or Selling Plan Product. Auto-adds the gift to the cart without a click, if the product is free.

Display Conditions — rules that control when Gift Unlock appears (cart total, product in cart, customer tag, etc.). Click Add Rule Group to configure. The extension only shows when all conditions are met.

Gift Message tab

The teaser banner shoppers see during checkout. The tab has an enable/disable toggle at the top — when off, the banner is hidden and several options in the Offer tab are hidden too.

  • Display Title — main headline. Default: "There's a gift waiting for you!"

  • Display Subtitle — secondary line. Default: "Go through checkout to claim it"

  • Button Display Text — CTA label. Default: "See gift"

  • Button Appearance — color style using Shopify design tokens: Base, Accent, Decorative, Interactive, Subdued, Info, Success, Warning, Critical, Monochrome.

  • Gift Icon — defaults to a gift box. Click Change > Upload new to swap, or Reset to default.

Advanced Styling — Main Background

  • Border — None, Base, Dotted.

  • Border Width — Base or Medium.

  • Corner Radius — None, Small, Base, Large, or Fully Rounded.

  • Padding — None through Small 100–500 and Base up to Large 100–500.

Offer tab

The actual gift offer. Content depends on Offer Type and whether Gift Message is on or off.

Note: The Information Provided / Information Not Provided sub-tabs and the Display As Pop Up option only appear when Gift Message is on. With Gift Message off, the offer renders inline in the checkout page and those options are hidden.

Offer Type = Product

Information Provided / Information Not Provided (only visible when Gift Message is on) — separate configurations for two states: before the shopper interacts with the banner, and after.

Gift Mode

  • Single Gift — one product/variant, no selection.

  • Multiple Gifts — shopper picks from several.

  • + Add Product — choose the gift product(s).

  • Hide Product Details From Pop Up — hides name, image, and price; only action buttons show.

  • Hide Offer If The User Already Has This Product In Their Cart — hides the offer if the gift is already in the cart.

  • Set Discount Configuration — define a discount on the gift product (e.g. 100% off to make it free).

  • Display As Pop Up (only visible when Gift Message is on) — modal overlay vs. inline.

  • Display Title — default "Here's your gift".

  • Display Subtitle — optional supporting line.

  • Button Display Text — default "I want this!".

  • Button Appearance — color style.

  • Decline Button Text — default "No thank you".

Offer Type = Selling Plan Product

The Offer tab switches to subscription/selling-plan configuration.

  • Product Or Variant ID (required) — the specific product or variant to offer. See "How to find a Product or Variant ID" below.

  • Selling Plan ID (required) — the subscription frequency to associate with the gift.

  • Hide Product Details From Pop Up

  • Hide Offer If The User Already Has This Product In Their Cart

  • Set Discount Configuration

  • Pop Up Display Title — default "Here's your gift".

  • Pop Up Display Subtitle — optional.

  • Call To Action Button Text — default "I want this!".

  • Decline Button Text — default "No thank you".

The Gift Unlock banner won't show if the selected product is out of stock.

Offer Type = Coupon

  • Coupon Type — Fixed amount or Percentage.

  • Coupon Value — dollar value or percentage.

  • Expires In (Days) — days the coupon stays valid after unlock. Leave blank for no expiration.

  • Auto-Apply Coupon If Unlocked — automatically applies once unlocked.

  • Combines With — Product Discounts, Order Discounts, Shipping Discounts.

  • Pop Up Display Title — default "Here's your gift".

  • Pop Up Display Subtitle — optional.

  • Call To Action Button Text — default "I want this!".

  • Decline Button Text — default "No thank you".

Advanced Styling (all Offer Types)

  • Main Background — border, border width, corner radius, and padding for the offer block.

  • Image — same controls for the product image area (Product and Selling Plan Product only).

Save and preview

Click Save in the top-right once all three tabs are configured. Use the Preview panel on the right to see how it looks — toggle Desktop/Mobile, or click Preview In Shopify for a live preview in your Shopify checkout editor.

Activate in Shopify

Only after saving in PDQ are you ready to make the extension live.

  1. In the Settings tab, find the Token for Shopify section.

  2. Copy the token using the copy icon.

  3. Open your Shopify Online Store Editor (a direct link is on the page).

  4. Locate the Gift Unlock Token component and paste in the token.

  5. Save and publish in Shopify.

For the full extension install walkthrough that applies to any PDQ extension, see Adding a PDQ Extension to your Shopify checkout.

How to find a Product or Variant ID

  • Go to Shopify > Products and pick the product or variant.

  • If you're offering a product as a gift, open it. The Product ID is at the end of the URL.

Finding a Variant ID

  • Open the product, then open the desired variant. The Variant ID is at the end of that URL.

Once you have the ID, paste it into the matching field in PDQ.

Tips

  • For a free-product gift, set the Discount Configuration to 100% off and turn on Auto-Apply Gift If Product Is Free so it lands in the cart automatically.

  • For coupons, Combines With stops your gift from clashing with other promos. Tick all three only if you've stress-tested the math.

  • Use Display Conditions to restrict the gift — for example, only above a cart total, or only for new customers.

  • Use the Information Provided / Information Not Provided sub-tabs to surprise-and-delight: hide product details until the shopper engages with the banner.

Happy gifting! If anything's unclear, reach out to support@prettydamnquick.com.

Did this answer your question?