Offer engine V2
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:
Open Shopify Theme Editor
Go to App Embeds
Enable Dollarlabs Core
This is required for automatic cart calculations and gift management.
Offer Bar Block
Displays offers directly on product pages.
To enable:
Open a Product Template in the Theme Editor
Add the Offer Bar block
Save the theme
Configuring an Offer
Basic Information
Internal Title
Used only inside the app for identification.
Example:
Discount Title
Customer-facing title displayed in widgets.
Example:
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:
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:
Offer Types
Offer Engine V2 supports two primary offer categories:
BOGO Offers
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
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:
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:
Rule:
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:
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:
Both gifts are automatically added to the cart.
Quantity Breaks
Quantity Breaks allow merchants to offer discounted pricing when customers purchase larger quantities.
Example
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:
Result:
Increase quantity:
Result:
Example: Buy 12 Get Gift List
Rule:
Cart Quantity:
Result:
Because the offer has been qualified twice.
Example: Buy 3 Get Specific Gift
Rule:
Cart Quantity:
Result:
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.
Last updated