For the complete documentation index, see llms.txt. This page is also available as Markdown.

Offer Types

Understanding Checkout Extension Offer Types

Before diving into the detailed setup guides, it's helpful to understand the three core offer types supported by Checkout Extensions: Preset, Preset List, and BOGO.

These offer types can be used in both Auto Add Gift and Manual Selection modes, but they behave differently depending on which mode you choose.


Preset

A Preset offer contains a fixed set of products and quantities defined by the merchant.

For example:

  • Water Bottle Γ— 1

  • Tote Bag Γ— 2

Whenever the offer is triggered, these exact products and quantities are used.

Behavior in Auto Add Gift

The products are automatically added to the customer's cart when the offer conditions are met.

Example: Buy any Sneakers β†’ Automatically receive 1 Water Bottle.

Behavior in Manual selection

The customer is shown the products and can choose whether to add them to their cart.

Unlike Auto Add Gift, Manual Selection also supports:

  • Free products

  • Percentage discounts

  • Fixed-price offers

  • Full-price upsells

Example: Buy any Sneakers β†’ Add a Water Bottle at 50% off.


Preset List

A Preset List allows merchants to offer a collection of products rather than a fixed set.

For example:

  • Water Bottle

  • Tote Bag

  • Coffee Mug

  • Keychain

Behavior in Auto Add Gift

Products from the list are automatically added to the cart based on the configuration.

You can choose:

  • Fixed quantities

  • Dynamic quantities derived from cart conditions

Buy 3 qualifying products β†’ Automatically receive:

  • Water Bottle Γ— 1

  • Tote Bag Γ— 1

Behavior in Manual selection

The customer chooses products from the list.

You can control:

  • How many products they can select

  • Whether products are free or discounted

  • Whether the selection limit scales dynamically

Buy 3 qualifying products β†’ Choose 1 free gift from the list.

Buy 6 qualifying products β†’ Choose 2 free gifts from the list.


BOGO

BOGO (Buy One Get One) creates offers where rewards are derived from products already present in the cart.

Instead of choosing a predefined gift, the offer is calculated using qualifying products.

Behavior in Auto add gift

Rewards are automatically added to the cart.

Supported modes include:

Match Cart Line Quantity

Mirror the quantity purchased.

Example: Buy 2 Sneakers β†’ Receive 2 Sneakers for free.

Fixed Quantity

Limit the reward quantity regardless of how many products are purchased.

Example: Buy 10 Sneakers β†’ Receive 1 free Sneaker.

Dynamic Quantity

Calculate rewards using a formula.

Example: For every 3 qualifying items purchased, receive 1 free item.

Behavior in manual selection

The same BOGO calculations apply, but customers choose whether to add the rewards themselves.

This provides a more interactive experience and allows customers to decide which qualifying rewards they want to claim.

Example: Buy 6 qualifying items β†’ Eligible for 2 free rewards. The customer chooses which rewards to add.


At a Glance

Offer Type
Auto Add Gift
Manual Selection

Preset

Automatically adds predefined products

Customer chooses whether to add predefined products

Preset List

Automatically adds products from a configured list

Customer chooses products from a list

BOGO

Automatically calculates and adds rewards based on cart contents

Calculates rewards but customer chooses which rewards to claim

In general, Auto Add Gift is best when you want a seamless, hands-off customer experience, while Manual Selection is best when you want to give customers choice, run upsells, or offer discounted products in addition to free gifts.

Last updated