--- title: "Setting Up Checkbox Upsell" description: "Add one to three optional products to Shopify Checkout that customers can tick to add and untick to remove." url: https://docs.orderediting.com/en/articles/15323738-setting-up-checkbox-upsell collection: "Placement Setup Guides" updated: 2026-11-05 language: en --- # Setting Up Checkbox Upsell Add one to three optional products to Shopify Checkout that customers can tick to add and untick to remove. # Before you begin - Checkbox Upsell uses a checkout app block and requires Shopify Plus. - You need permission to edit and save the published checkout profile. - Choose active products that are available in each selected market. Each product is added in one tap, with no variant selector, so pick products or variants customers can add without choosing a size or option. # Create the recommended strategy 1. Open **Apps > Order Editing > Upsells**. 2. Select **Create strategy**. 3. Choose **Checkbox Upsell**, then select **Continue**. Add a **Single Product** module for the add-on. 4. Choose the Shopify markets that can see the offer. 5. Select the product customers can add, or change the module to a different supported product source. 6. Add concise offer copy and any required customer targeting. 7. Keep the strategy in **Draft**, preview it, and save. # Choose where the products come from Checkbox Upsell shows products from sources you control. It supports these modules:

Module	What it offers
Single Product	The product you pick.
Group of Products	Products you pick as a group.
Collection	Products from a collection you choose.
Keyword Search	Products that match a storefront search you set.
Complementary Products	The pairings you set up in Shopify Search & Discovery.
Metafields	Products linked to the purchased product through a metafield.

Automatic recommendation modules, subscription modules and Mix and Match are not available for this placement, because they can offer products that need a choice before they are added. The block shows as many products as **Shown at once** allows, up to the strategy's quantity limit. When a source returns fewer eligible products, fewer rows appear. # Choose the offer presentation If the strategy editor shows **Appearance**, configure appearance there before saving. For an existing strategy, select **Customize appearance** to copy compatible app branding. Shopify editor overrides cannot be copied automatically, so review the result before saving. Select **Customize appearance** on the **Appearance** card to open the settings on the left and the preview on the right. **Expand** on the preview opens the same workspace for a configured checkbox placement. Compare **Upsell only** and **Full checkout**, then use the mobile and desktop preview controls to check both sizes. ## Products - **Shown at once** sets how many products customers can tick: **One**, **Two** or **Three**. Each product has its own checkbox that adds or removes only that product. Shopify suggests showing no more than two offers at a time. - **Show an Add all button** appears when two or three products are shown. It adds a button under the products, such as **Add both** or **Add all 3**, with their total. It adds every product that is still unticked in one tap, and shows while two or more are left to add. It is off by default. - **Button color** appears when the Add all button is on. **Secondary** is the default and keeps **Pay now** the strongest button on the page. **Primary** uses your checkout's accent color. ## Layout **Compact** shows the product title and price without an image and is the default. **Detailed** adds the product image and its supported shape and fit controls. Switching between them keeps your product count, Add all button, control, border and price settings. ## Offer message **Offer message** is read-only in **Appearance**. Edit the title and description in the strategy's **Message** step. A module with its own wording keeps its override. Checkbox Upsell does not have an add-to-cart button text control in this workspace. Choose **Text** for start, centre or end alignment of the offer title and description. Native **Heading** uses start alignment. This does not change the control, product name or price alignment. With two or three products, the offer title shows only when every product uses the same message. Otherwise, the block shows **Add to your order** as its title. ## Control - **Control** chooses what customers tick: **Checkbox** or **Toggle**. It is available only when one product is shown. With two or three products, each product always uses a checkbox. - **Control position** puts the control on the **Left** or **Right** of the offer. It follows the language direction, so it swaps sides in right-to-left checkouts. ## Borders and price - **Borders** controls **Draw a box around the offer**, which adds a border and a little padding around the whole offer. It is on by default. With two or three products, the box holds all of them with a line between each. Without it, the products stack without a box. - **Sale price color** styles the discounted price using checkout colors. It does not add a badge. **Show savings** adds what the product saves when it costs less than usual. Existing strategies keep showing one product with a checkbox on the left until you change these settings. ## Save your changes Select **Save strategy** to save the whole strategy, including other pending strategy edits. **Discard** undoes workspace edits since opening it or last saving there, without removing strategy-page edits that were already pending when you opened it. **Reset to default** stays an unsaved change until you save. **Save as default** makes this look the starting point for new strategies that use Checkbox, without changing existing ones. All blocks selecting this strategy share its appearance. If publication is incomplete, reopen the saved strategy and select **Retry publication** before checking checkout. # Add the checkout app block 1. Open the Checkbox Upsell setup action in Order Editing. 2. Continue to Shopify's checkout editor. 3. Select **Add app block** where the offer should appear and choose **Checkbox Upsell**. 4. Place it near the relevant shipping or payment step without competing with the order summary. 5. For an existing legacy strategy, choose whether the block shows product details and its card border. For a strategy using managed **Appearance**, those legacy appearance fields are ignored. 6. Save the checkout profile. # Optional: lock the strategy to the block Use a locked strategy when this exact block must request this exact offer. 1. In the strategy, enable **Only show this strategy when an app block requests it by ID**. 2. Copy the strategy ID. 3. In Shopify's checkout editor, open the **Checkbox Upsell** block. 4. Paste the ID into **Locked Strategy** and save. The strategy is then excluded from normal matching and does not appear anywhere else unless another supported app block requests the same ID. # Check it in checkout 1. Activate the strategy when its products, targeting, and market are ready. 2. Add a qualifying product to the cart and continue to checkout without placing an order. 3. Confirm each checkbox is initially unticked. 4. Tick a product and confirm it is added without leaving or reloading checkout. 5. Untick it and confirm the product is removed and totals update. 6. If you show two or three products with an Add all button, select it and confirm every unticked product is added. 7. Repeat with a cart that should not match the strategy. If a product cannot be added, its row unticks and shows the error under that product. ## Related - [Setting Up the One-Click Upsell](https://docs.orderediting.com/en/articles/14408304-setting-up-the-one-click-upsell.md) - [Setting Up Order Status Page Upsells](https://docs.orderediting.com/en/articles/14429370-setting-up-order-status-page-upsells.md) - [Setting Up Thank You Page Upsells](https://docs.orderediting.com/en/articles/14429369-setting-up-thank-you-page-upsells.md) - [Setting Up the Free Shipping Upsell](https://docs.orderediting.com/en/articles/13808696-setting-up-the-free-shipping-upsell.md) - [Setting Up Checkout Upsells](https://docs.orderediting.com/en/articles/13825630-setting-up-checkout-upsells.md)