> 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/offer-engine-v2.md). # Offer engine V2 {% embed url="" %} *** ### Overview Offer Engine V2 is the next generation of Offer Engine V1, designed to make creating promotions, volume discounts, and BOGO offers significantly more flexible and powerful. While Offer Engine V1 supported: * Percentage discounts * Fixed amount discounts * Volume tier pricing * Free Gift With Purchase offers * Product and Collection page widgets it was limited to a single offer list per store. Offer Engine V2 introduces: * Multiple BOGO offer types * Advanced volume discounts * Automatic gift management * Customer-selectable gifts * Multiple quantity breakpoints * Improved product page widgets * Automatic cart synchronization * Fully customizable offer appearance *** ## Getting Started ### Step 1: Create an Offer Navigate to: **Offer Engine V2 → Create Offer** After creating an offer, you will see two theme extensions: #### Core Embed Handles all offer logic and cart updates. To enable: 1. Open Shopify Theme Editor 2. Go to **App Embeds** 3. Enable **Dollarlabs Core** This is required for automatic cart calculations and gift management. #### Offer Bar Block Displays offers directly on product pages. To enable: 1. Open a Product Template in the Theme Editor 2. Add the **Offer Bar** block 3. Save the theme *** ## Configuring an Offer ### Basic Information #### Internal Title Used only inside the app for identification. Example: ``` Holiday Sale ``` #### Discount Title Customer-facing title displayed in widgets. Example: ``` Holiday Sale ``` *** ### Scope Choose where the offer applies. Supported scopes include: * Products * Variants * Collections #### Exclusions Even when targeting an entire collection, you can exclude specific products. Example: ``` Collection: Hydrogen Exclude: Product A ``` *** ### Placements Choose where the offer appears. #### Currently Supported * Product Page #### Coming Soon * Cart Page * Collection Page *** ### Display Conditions Control when customers see the offer. Examples: #### Customer Targeting Show offers only to: * Logged-in customers * Specific customer segments #### URL Targeting Display offers only on specific URLs or campaigns. Example: ``` Only show on: ?campaign=summer-sale ``` *** ## Offer Types Offer Engine V2 supports two primary offer categories: 1. BOGO Offers 2. Quantity Breaks *** ## BOGO Offers ### 1. Buy X, Get Same Item Free The customer receives the same product for free. #### Example Buy 1 → Get 1 Free | Purchased | Free | | --------- | ---- | | 1 | 1 | | 2 | 2 | | 3 | 3 | The free quantity automatically scales with the purchased quantity. #### Custom Buy/Get Ratios You can modify both quantities. Example: ``` Buy 3 Get 1 Free ``` | Purchased | Free | | --------- | ---- | | 3 | 1 | | 6 | 2 | | 9 | 3 | *** ### 2. Buy From Scope, Get Specific Gift Customers purchase products from the configured scope and automatically receive a predefined gift. #### Example Offer Scope: ``` Hydrogen Collection ``` Rule: ``` Buy 3 products Get Free Water Bottle ``` When the customer purchases 3 eligible products, the specified gift is automatically added to the cart. *** ### 3. Choose Gift Customers earn a gift but can choose which gift they want. #### Example Rule: ``` Buy 3 products Choose 1 free gift ``` Available Gifts: * Water Bottle * Tote Bag * Notebook The customer selects their preferred gift directly from the offer widget. *** ### 4. Buy X, Get Gift List Customers receive multiple predefined gifts automatically. #### Example Rule: ``` Buy 12 products Receive: - Gift A - Gift B ``` Both gifts are automatically added to the cart. *** ## Quantity Breaks Quantity Breaks allow merchants to offer discounted pricing when customers purchase larger quantities. #### Example | Quantity | Price | | -------- | ---------------- | | 1-9 | Regular Price | | 10-49 | Discounted Price | | 50+ | Best Price | Multiple breakpoints can be configured within a single offer. *** ## Automatic Cart Scaling One of the biggest improvements in Offer Engine V2 is automatic cart synchronization. Whenever a customer changes quantities in the cart: * Gift quantities update automatically * BOGO quantities recalculate automatically * Volume discounts remain accurate No manual adjustments are required. *** ### Example: Buy 1 Get 1 Free Customer Cart: ``` Product Quantity = 2 ``` Result: ``` Free Quantity = 2 ``` Increase quantity: ``` Product Quantity = 5 ``` Result: ``` Free Quantity = 5 ``` *** ### Example: Buy 12 Get Gift List Rule: ``` Buy 12 Receive: - Gift A - Gift B ``` Cart Quantity: ``` 24 Products ``` Result: ``` Gift A = 2 Gift B = 2 ``` Because the offer has been qualified twice. *** ### Example: Buy 3 Get Specific Gift Rule: ``` Buy 3 Get Free Water Bottle ``` Cart Quantity: ``` 6 Products ``` Result: ``` 2 Free Water Bottles ``` Offer rewards automatically scale based on qualifying quantities. *** ## Customizing the Offer Widget Offer Engine V2 includes extensive customization options. ### Content Customize all customer-facing text. Examples: * Offer titles * Button labels * Gift selection messages * Quantity break descriptions A live preview updates as changes are made. *** ### Appearance Match the widget to your store branding. Customize: * Primary colors * Background colors * Text colors * Borders *** ### Advanced Styling Add custom CSS for complete control over widget styling. Example use cases: * Custom spacing * Typography adjustments * Unique layouts * Brand-specific styling *** ## Need Help? If you need assistance configuring an offer or have a use case that isn't currently supported, feel free to reach out to the Dollarlabs team. We're happy to help you get the most out of Offer Engine V2. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.dollarlabs.io/dollarlabs-ultimate-discounts/offer-engine-v2.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.