Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.atomcommerce.io/llms.txt

Use this file to discover all available pages before exploring further.

  • Purpose: Controls whether this offer excludes qualifier lines already used by another offer
  • Default: Unchecked (shared qualifiers are allowed)
  • Business Impact: Balances customer satisfaction with margin protection

What This Feature Does

This feature controls whether items that have already acted as qualifiers for one offer can also act as qualifiers for other offers.
This feature is controlled by the “Exclude items already used to qualify for another offer” checkbox in the Discount Limits section. By default, this checkbox is unchecked, which allows qualifier reuse across offers.
  • Older documentation described this as “Allow items to qualify for multiple offers”.
  • Current UI uses inverse wording: “Exclude items already used to qualify for another offer”.
  • Equivalent mapping: Allow = Unchecked, Disallow = Checked.

Key Concepts

  • Qualifier: Items that trigger/activate a discount (e.g., items that meet the “buy X” requirement)
  • Target: Items that receive the discount (e.g., the free gift or discounted item)
  • Qualifier Reuse: Allowing the same item to qualify for multiple different offers

How It Works

When Unchecked (Default)

  • The “Exclude items already used to qualify for another offer” checkbox is unchecked
  • Items that qualified for Offer A can also qualify for Offer B
  • Shared qualifier behavior is allowed

When Checked

  • The “Exclude items already used to qualify for another offer” checkbox is checked
  • Items that qualified for Offer A cannot qualify for Offer B
  • Prevents “double qualifying” scenarios for this offer

Real-World Examples

Example 1: Fashion GWP Offers

Scenario: Two Gift With Purchase offers
  • Offer A: “Buy any dress, get free jewelry” (Priority 1)
  • Offer B: “Buy any dress, get free handbag” (Priority 2)
Customer Action: Buys 1 dress ($50)

Unchecked (Default)

  • Dress qualifies for Offer A → Customer gets free jewelry
  • Dress can also qualify for Offer B → Customer gets free handbag
  • Result: Customer gets 2 gifts

Checked

  • Dress qualifies for Offer A → Customer gets free jewelry
  • Dress cannot qualify for Offer B → Customer does NOT get free handbag
  • Result: Customer gets 1 gift

Example 2: Beauty Product GWP Offers

Scenario: Multiple beauty gift with purchase offers
  • Offer A: “Buy any skincare product, get free cleanser”
  • Offer B: “Buy any skincare product, get free moisturizer”
Customer Action: Buys 1 skincare product ($30)

Unchecked (Default)

  • Skincare product qualifies for Offer A → Customer gets free cleanser
  • Skincare product also qualifies for Offer B → Customer gets free moisturizer
  • Result: Customer gets 2 free products

Checked

  • Skincare product qualifies for Offer A → Customer gets free cleanser
  • Skincare product cannot qualify for Offer B → Customer does NOT get free moisturizer
  • Result: Customer gets 1 free product

Example 3: Beauty Product Bundle Offers

Scenario: Multiple beauty GWP offers requiring multiple items
  • Offer A: “Buy 2 skincare products, get free cleanser”
  • Offer B: “Buy 2 skincare products, get free moisturizer”
Customer Action: Buys 2 skincare products

Unchecked (Default)

  • Both offers apply
  • Customer gets both free products

Checked

  • Only highest priority offer applies
  • Customer gets 1 free product

When to Check This Setting

Margin Protection

Prevent excessive discount stacking that could erode profits

Controlled Promotions

Maintain predictable discount costs and avoid surprises

Simple Campaigns

Avoid complex qualifying scenarios for straightforward promotions

Budget Constraints

Limit total discount exposure to stay within promotional budgets

When to Leave It Unchecked

Generous Promotions

When you want customers to receive multiple benefits from the same qualifying items

Holiday Campaigns

Special occasions where extra gifts increase customer satisfaction

Customer Acquisition

Competitive advantage through better value propositions

Inventory Clearance

Move multiple product categories simultaneously

How to Configure

Step 1: Navigate to Your Offer

  1. Go to the Atom admin interface
  2. Find the offer you want to configure
  3. Click to edit the offer

Step 2: Locate Discount Limits

  1. Scroll down to the Discount Limits section
  2. Look for the “Exclude items already used to qualify for another offer” setting

Step 3: Configure the Setting

  1. Check the box to exclude shared qualifiers (items already used by another offer are not reused)
  2. Leave unchecked to allow qualifier reuse across offers (default behavior)
  3. Save your changes
This setting works with all offer types including BXGY, BMSM, GWP, Order Discount, and more. The priority system still applies - higher priority offers are evaluated first.

Business Impact Analysis

Positive Impacts

  • Higher Customer Satisfaction: Customers receive more gifts and benefits
  • Increased Average Order Value: Better value propositions encourage larger purchases
  • Inventory Movement: Can help clear multiple product categories simultaneously

Potential Risks

  • Higher Discount Costs: Multiple offers applying to the same items increases promotional expenses
  • Margin Erosion: Excessive discounting can impact profitability
  • Budget Overruns: May exceed planned promotional budgets

Best Practices

Testing Your Configuration

  1. Test with simple scenarios first to verify behavior
  2. Create test orders with multiple qualifying items
  3. Verify expected outcomes match your business goals

Monitoring Performance

  • Track discount costs after enabling the feature
  • Monitor checkout performance for any slowdowns
  • Analyze customer behavior to ensure the feature achieves your goals

Strategic Planning

  • Start with conservative settings and gradually enable more generous behavior
  • Set clear budgets for total discount exposure
  • Regular reviews to assess whether the feature is meeting business objectives

Common Use Cases

Fashion Retail

  • Multiple GWP offers on the same qualifying items
  • “Buy any dress” promotions that can stack with other dress offers
  • Seasonal campaigns with overlapping qualifying criteria

Beauty & Cosmetics

  • Skincare product bundles with multiple free gifts
  • Makeup offers that can combine with skincare promotions
  • Holiday gift sets with multiple qualifying scenarios

Electronics

  • Accessory bundles with multiple free items
  • Device offers that can stack with accessory promotions
  • Seasonal sales with overlapping product categories

Troubleshooting

Common Issues

Issue: Items aren’t qualifying for multiple offers
  • Solution: Confirm this checkbox is unchecked and verify qualifying conditions are met for each offer
Issue: Unexpected high discount costs after enabling
  • Solution: Review your offer configurations and consider adding additional limits or conditions
Issue: Performance issues during checkout
  • Solution: Monitor system performance and consider the complexity of your offer configurations

Debugging Steps

  1. Verify the setting is properly enabled in the admin interface
  2. Check offer priorities to ensure they’re configured correctly
  3. Test with simple scenarios to isolate the issue
  4. Review offer conditions to ensure they’re compatible with qualifier reuse

FAQ

Q: Does this feature affect all offer types? A: Yes, this feature works with all offer types including BXGY, BMSM, GWP, Order Discount, and more. Q: How does priority work with qualifier reuse? A: Priority still applies - higher priority offers are evaluated first. The feature only affects whether items can qualify for multiple offers after the priority evaluation. Q: What does checked vs unchecked mean now? A: Checked means exclude lines already used as qualifiers by another offer. Unchecked means allow shared qualifiers. Q: Can I enable this for some offers but not others? A: Yes, this setting is configured per offer, so you can have different qualifier reuse policies for different offers. Q: What’s the performance impact of enabling this feature? A: There may be a slight increase in processing time for complex cart scenarios, but it’s generally minimal for most use cases. Q: How do I know if this feature is right for my business? A: Start with the default setting (unchecked, shared qualifiers allowed) if you want more generous stacking. Check it when you need tighter margin control and stricter qualifier isolation.