# Setting up Gift With Purchase Unlock Offer shoppers a free product, subscription gift, or coupon at checkout — with custom messaging and styling. May 7, 2026 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](https://support.prettydamnquick.com/en/articles/8560867-adding-multiple-pdq-components). ## 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](mailto:support@prettydamnquick.com).