# 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](https://support.prettydamnquick.com/en/articles/8560867-adding-multiple-pdq-components).

## 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](mailto:support@prettydamnquick.com) if you have any questions.