Coupons & BOGOF
SpecCart extends WooCommerce coupons with Buy One Get One Free (BOGOF) support specifically designed for configured eyewear. When enabled, the cheapest qualifying frame is free while lens add-ons are always charged at full price.
How BOGOF Works
Section titled “How BOGOF Works”When a customer applies a BOGOF coupon at checkout:
- SpecCart collects all configured eyewear items in the cart
- Items are filtered by the minimum frame price threshold (if set)
- Qualifying items are sorted by frame price, highest first
- Items are paired off — in each pair, the cheaper frame is free
- Odd items out (e.g. 3rd item with no pair) pay full price
- Lens add-ons are never discounted — only the frame cost
Examples:
| Cart Items | Frame Prices | Result |
|---|---|---|
| 2 items | £79, £59 | £59 frame free |
| 3 items | £99, £79, £59 | £79 frame free (paired with £99). £59 unpaired, pays full |
| 4 items | £99, £89, £79, £59 | £89 and £59 frames free (two pairs) |
Creating a BOGOF Coupon
Section titled “Creating a BOGOF Coupon”- Go to WooCommerce > Coupons > Add new
- Give the coupon a code (e.g. “BOGOF”, “2FOR1”, “PAYDAY”)
- Scroll to the SpecCart BOGOF section
- Tick BOGOF Mode
When BOGOF Mode is enabled:
- The discount type automatically locks to “Percentage discount”
- The coupon amount locks to 0 (BOGOF overrides it entirely)
- Three BOGOF-specific fields appear
BOGOF Fields
Section titled “BOGOF Fields”Min frame price Sets the minimum frame price for an item to qualify for the BOGOF offer.
- Leave at 0 for no minimum (all frames qualify)
- Set to e.g. 59.00 to exclude budget frames below £59
- Both the paid and free items must meet this threshold
- Items below the threshold are ignored entirely — they don’t participate in pairing
Cart label The text shown next to the discount in the cart and checkout totals.
- Defaults to “Buy 1 Get 1 Free” if left empty
- Customise to match your marketing (e.g. “2 for 1 on frames”, “PAYDAY DEAL”)
- Supports any plain text
Optional WooCommerce Settings
Section titled “Optional WooCommerce Settings”All standard WooCommerce coupon options still apply alongside BOGOF:
- Coupon expiry date — Set a promotion end date
- Usage limits — Limit total uses or per-customer uses
- Usage restrictions — Restrict to specific email addresses
- Allow free shipping — Combine with free shipping offers
Quantity Handling
Section titled “Quantity Handling”BOGOF works with both separate line items and quantity-based items:
Separate line items (most common with SpecCart — each configuration is unique):
- 2 line items = 1 free frame
- 4 line items = 2 free frames
Same product with quantity > 1 (identical configurations):
- Qty 2 = 1 free, discount spread evenly per unit
- Qty 3 = 1 free, discount spread across all 3 units
Cart Display
Section titled “Cart Display”When a BOGOF coupon is applied, the cart totals show:
- Label: Your custom cart label (or “Buy 1 Get 1 Free”)
- Amount: The total frame discount (sum of all free frames)
- Remove link: Customers can remove the coupon as normal
The discount amount reflects only the frame cost of the free item(s). Lens add-ons, coatings, and other lens charges are never included in the BOGOF discount.
Validation
Section titled “Validation”BOGOF coupons automatically require at least 2 configured eyewear items in the cart. If a customer tries to apply a BOGOF coupon with only 1 item, they see:
“This coupon requires at least 2 configured eyewear items in your cart.”
Non-configured products (regular WooCommerce products without lens configuration) are not counted.
Best Practices
Section titled “Best Practices”- Set a minimum frame price to avoid giving away your cheapest frames for free
- Use clear coupon codes that match your marketing campaigns
- Customise the cart label to reinforce the promotion messaging
- Set usage limits to control the promotion’s reach and cost
- Set an expiry date so promotions don’t run indefinitely
- Test with different cart combinations before launching — try 2, 3, and 4 items with various frame prices
Troubleshooting
Section titled “Troubleshooting”Coupon applied but discount is £0
- Check the minimum frame price — items below the threshold don’t qualify
- Ensure at least 2 configured items are in the cart
- Verify BOGOF Mode is ticked on the coupon
Discount amount seems wrong
- BOGOF only discounts the frame price, not lens add-ons
- With 3 items, only 1 is free (the cheapest in the top pair)
- Check which items meet the minimum frame price threshold
Coupon not appearing as BOGOF in cart
- Verify the SpecCart BOGOF section shows “BOGOF Mode” ticked
- Save the coupon after enabling BOGOF