> For the complete documentation index, see [llms.txt](https://help.dollarlabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dollarlabs.io/dollarlabs-ultimate-discounts/checkout-extensions.md). # Checkout Extensions ## Understanding Checkout Extensions {% embed url="" %} *** ### What Are Checkout Extensions? Checkout Extensions allow you to present offers to customers directly during checkout. These offers can: * Automatically add free gifts * Let customers choose rewards * Offer discounted products * Create BOGO promotions * Create upsell opportunities * Create cross-sell opportunities Instead of building multiple discount rules and custom workflows, Checkout Extensions allow merchants to create sophisticated promotions through a visual configuration interface. *** ### Two Ways Checkout Extensions Work Checkout Extensions operate in two primary modes: #### Auto Add Gift In this mode, products are automatically added to the cart once the customer qualifies. The customer does not need to make any selections. Example: > Buy any pair of sneakers and receive a free water bottle automatically. The free gift appears in the cart as soon as eligibility requirements are met. *** #### Manual Selection In this mode, customers are shown a selection interface and choose the products they want. Example: > Buy any pair of sneakers and choose one free gift from: > > * Water Bottle > * Tote Bag > * Coffee Mug The customer decides which item gets added. *** ### When Should You Use Auto Add Gift? Auto Add Gift works best when: * The customer doesn't need choices * You want the simplest possible experience Examples: * Free samples * Free accessories * Packaging upgrades * Free branded merchandise *** ### When Should You Use Manual Selection? Manual Selection works best when: * Customers should choose their reward * Multiple products are available * You want to run upsells * You want to run cross-sells Examples: * Pick your free gift * Add accessories at 50% off * Choose one of three bonus items *** ### Why Manual Selection Is More Powerful Auto-added products must generally be free. Manual Selection allows merchants to offer: * Free products * Percentage discounts * Fixed-price offers * Full-price recommendations Examples: | Offer | Possible? | | ---------------------------- | --------- | | Free Water Bottle | ✅ | | Tote Bag at 50% Off | ✅ | | Add Coffee Mug for $5 | ✅ | | Suggested Full-Price Product | ✅ | *** ### How Checkout Extensions Decide When To Show Every Checkout Extension has a trigger. Triggers determine when customers become eligible. There are three primary trigger methods: #### 1. Discount Code Applied The offer appears only when a customer enters a specific discount code. Example: ``` FREEGIFT ``` Customer enters: ``` FREEGIFT ``` Gift becomes available. *** #### 2. Conditions Are Met The offer appears automatically when cart conditions are satisfied. Example: * Cart contains Sneakers * Cart subtotal exceeds $100 Offer appears automatically. *** #### 3. Combination of Rules Merchants can combine multiple conditions together. Example: * Customer buys Sneakers * Cart value exceeds $100 * Customer belongs to VIP segment Only then is the offer shown. *** ### What Can Checkout Extensions Be Used For? #### Free Gifts Spend $100 → Get Free Tote Bag *** #### BOGO Buy 1 Get 1 Free Buy 2 Get 2 Free Buy 3 Get 1 Free *** #### Cross Sell Buying Sneakers? Add Matching Socks at 30% Off *** #### Upsell Buying Running Shoes? Upgrade to Premium Insoles for $10 *** #### Bundle Incentives Buy 3 Products Choose 1 Bonus Product *** ### Next Step Now that you understand the two primary modes, the next article covers the trigger system and how Checkout Extensions determine customer eligibility.