Every PDQ checkout extension connects to Shopify through a token - a unique code linking your configured extension in PDQ to its block in Shopify's checkout editor. The flow below is identical for every extension; only the block name, token field label, and where the block is placed differ.
Step 1: Configure, save, and activate in PDQ
In PDQ, go to Extensions → Add Extension, choose the extension type, configure it, and click Save. Activate the extension (toggle it on) - an inactive extension won't render even if the block is installed. The token is generated automatically and always lives in the Settings tab under Token for Shopify.
Step 2: Copy the token
Open your extension in PDQ and go to the Settings tab.
Find the Token for Shopify section.
Click the copy icon next to the token field to copy it to your clipboard.
Step 3: Add the extension block in Shopify
Shopify Admin → Settings → Checkout → Edit on your live checkout profile.
Click Add block and select the matching PDQ block for your extension.
Place it in the correct location (see the placement table below).
In the block's settings, paste your token into its token field (named per extension, e.g. Custom Upsell Token, Upsell Token, Urgency Boost Token, or "Enter desired … token").
If the block sits inside a shipping method, also fill Enter linked shipping method names (comma-separated; add …description too when several methods share a name).
Then paste the token from PDQ:
Step 4: Save and publish in Shopify
Once the token is pasted, save your changes in Shopify. The extension is now live and visible to customers during checkout.
Where each extension goes
Placement isn't the same for every extension - some are flexible, some must sit in one specific spot or they silently won't render.
Extension | Standalone (main / order summary) | Directly under Shipping method | Inside a shipping method (line item) | Cart only |
Digital Upsell | ✅ | — | ✅ (linked) | — |
Checkout Upsell | ✅ | — | ✅ (linked) | — |
Gift Unlock | ✅ | — | ✅ (linked) | — |
Checkout Content / Trust Badges | ✅ | — | ✅ (linked) | — |
Shipping Rates Filter | — | ✅ (only spot) | — | — |
Cart Control | — | — | — | ✅ (only spot) |
Product Upgrade | ✅ (Standalone mode) | — | in cart/order summary (Line Item mode) | — |
"Linked to a shipping method" = placed inside Shipping method → Shipping option list, connected via the linked shipping method name/description fields.
Product Upgrade is special: its Display Mode must match placement - Line Item Action → inside the order-summary cart; Standalone Block → main checkout area. A mismatch logs as "displaying" but shows nothing.
⚠️ Shopify's 3-block limit (and Extension Groups)
Shopify allows only 3 app blocks per checkout section (e.g. under Shipping Methods). If a section is full - including any hidden/leftover blocks - a new PDQ block won't fit. Two fixes:
Remove unused blocks, or place the new one in a different section.
Use an Extension Group - a single PDQ block that bundles multiple extensions together, so several PDQ extensions run through one checkout block instead of consuming a slot each.
Multiple extensions
Each extension has its own token - repeat Steps 2–4 for each, pasting the correct token into its matching block. Don't reuse a token across blocks.
Not showing up? Quick checks
The extension is activated in PDQ (not just saved).
The token matches the block (right extension, right field).
The block is in the correct location for that extension (table above); for inside-a-method blocks, the linked shipping method name matches exactly.
The section isn't over Shopify's 3-block limit.
Any Display Conditions on the extension are actually met by your test cart.
Reach out to support@prettydamnquick.com if you're stuck.