Setting up upsells in checkout

Offer shipping protection, priority processing, warranties, or any digital add-on at checkout, with timers, display rules, and order tags

May 7, 2026

The Digital Upsell Extension

The Digital Upsell extension lets you offer a one-click add-on at checkout, typically on the Shipping step. It's built for low-friction items: shipping protection, priority processing, warranties, digital downloads, or anything you want in front of shoppers right when they're closest to buying.

At the top of the editor you'll see live performance metrics: Impressions, Revenue, and # of items purchased for the extension.

Where to find it

Go to Convert > Extensions in the left sidebar. Click the purple Add Extension button in the top-right corner and select Digital Upsell. The editor opens with two tabs: Settings and Timer, plus a live Preview panel on the right.

To edit, duplicate, copy a token, or delete an existing Digital Upsell, click the three-dot menu ( ⋯) on any extension card on the Extensions page. You'll see four options:

• Edit — opens the full settings editor.
• Copy Token — copies the Shopify integration token to your clipboard without opening the extension.
• Duplicate — creates a copy with all its settings.
• Delete — permanently removes the extension.

Heads up: saving creates an unlisted Shopify product

When you save a Digital Upsell for the first time, PDQ creates an unlisted digital product in your Shopify backend using the Title and Description text from the Settings tab. The product is hidden from your storefront and used only to process the upsell at checkout.

Because of this, three fields are locked once you save: Title, Description text, and Upload product image. Set them deliberately the first time — to change any of them later, you'll need to duplicate the extension and start over.

Step 1: Connect the extension to Shopify

After saving, the Token for Shopify appears at the top of the Settings tab. Click View Detailed Installation Instructions for the full walkthrough, or copy the token (it looks like custom_upsell_XXXXXXX) and paste it into the Custom Upsell Token component in your Shopify Theme Editor under your checkout settings.

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

Step 2: Configure the offer

In the Settings tab, set:

• Internal Name — for your reference only, not visible to shoppers (e.g. "Shipping Protection Upsell"). Editable any time.
• Title — the headline shoppers see (e.g. "Protect your shipping"). Locked after first save.
• Description text — the supporting line under the title, up to 255 characters. Locked after first save.
• Upload product image — .png only, max 500KB. Locked after first save.

Step 3: Choose where it appears

Under Component Placement:

• Standalone — the upsell shows as its own block in checkout, separate from any shipping method.
• Inside Shipping Method — embeds the upsell inside a specific shipping option. If you pick this, head to your Online Store Editor to define which shipping method it attaches to.

Step 4: Set the price

Under Choose Type:

• Fixed Rate — a flat dollar amount in Upsell Rate (e.g. $5.75).
• Percent — calculated as a percentage of the order value.

To layer on a discount:

• Apply Discount To — pick Upsell item (discount only the add-on) or Entire order.
• Discount % — the percentage to apply.

Step 5: Free items, tooltips, and order tags

A few extras worth knowing about:

• Auto-Select Only Free Digital Item at Checkout — if your upsell is $0, this auto-adds it to the cart.
• Enable Tooltip for Extra Details — adds an info icon next to the upsell. Reveals Tooltip Title (short heading) and Tooltip body (up to 5,000 characters).
• Custom Order Tags — auto-tag any order that includes the upsell.

Step 6: Set display conditions

Decide exactly when the upsell shows up. Add one or more rules — cart value, item count, collection, coupons, customer tags, destinations, device type, and more. Combine rules with Add Rule Group for AND/OR logic.

Under When cart no longer meets conditions:

• Keep in Cart — the upsell stays even if the cart changes.
• Remove from Cart — the upsell is pulled if the cart no longer qualifies.

Step 7: Add a countdown timer (optional)

The Timer tab adds urgency. Toggle Enable Countdown Timer on — the timer starts the moment a shopper hits checkout. Configure:

• Timer Duration — a number, then minutes or seconds.
• Time Format — Digital (01:30:45) or Compact (1Hr 30m).
• Placement — In Item Description, Inline Bar, or Badge.

Messages

Applies to Inline Bar. All fields support dynamic fields — type { to see options. The key one is {countdown}, which inserts the live time remaining.

Save and preview

Click Save in the top-right to save changes across both tabs. The first save creates the unlisted Shopify product. Cancel discards unsaved changes and returns to the Extensions list.

Tips

• For paid digital add-ons (shipping protection, warranties): use a Fixed Rate.
• For free items (downloadable guides, loyalty gifts): turn on Auto-Select Only Free Digital Item at Checkout.
• For premium services (priority processing): tick the Pin Order option to push tagged orders to the top of fulfillment.

Happy upselling! And as always, reach out to support@prettydamnquick.com if you have any questions.