Skip to main content

How can I resolve errors and manage bundle conflicts in Atlas?

Atlas Team avatar
Written by Atlas Team
Updated over a week ago

How Can I Resolve Errors and Manage Bundle Conflicts in Atlas?

When managing bundles in Atlas, you might encounter errors or limitations, particularly when applying bundles to all products or creating multiple bundles for the same scope. This article explains the causes behind these errors and provides actionable steps to address them. It also outlines essential discount rules to help you manage and optimize promotions effectively.

Understanding Bundle Application Rules in Atlas

Single Bundle Limitation for "All Products"

Atlas only allows a single bundle to be applied to “all products” at any given time. This means you cannot create a new bundle that applies to “all products” while another bundle is active for the same scope. Attempting to do so leads to an error stating:

"Cannot apply bundle to 'all products' when another bundle is already applied on 'all products' or 'specific collection' or 'specific products.'"

This restriction ensures clarity in promotional offers and prevents conflicting discounts or gifts from being applied simultaneously across your store. Another critical rule applied by Atlas involves the use of percentage-based discounts for bundles. Each item in a bundle receives an individual percentage discount rather than applying a single aggregated discount on the total value. Additionally, Atlas implements a "single promotion per product" rule to prevent a product from being attached to multiple promotions simultaneously. This ensures consistency and avoids potential errors or conflicts in active promotions.

Resolving Bundle Errors

Common Errors Users Encounter

The most common bundle-related error arises when trying to:

  • Apply a new bundle to "all products" but an active bundle already exists for this scope.

  • Use overlapping scopes such as "specific collections" or "specific products" while another bundle conflicts with them from a broader level.

  • Assign overlapping bundles or promotions to distinct product scopes to avoid triggering the "single promotion per product" conflict.

Steps to Fix the "Duplicate Bundle" Error

If you encounter the above error, you can:

  1. Modify the scope of your new bundle to apply it to “specific products” or “specific collections.”

  2. Alternatively, edit the existing bundle to stop applying it broadly. This frees up the "all products" scope for your new bundle.

  3. Ensure that any overlapping promotions targeting the same product are updated so only one promotion is active per product at a time.

Managing Bundle Settings Effectively

Modifying an Existing Bundle's Scope

To change an existing bundle's settings from "all products" to more specific targets:

  1. Open the bundle and click the Edit (pen) icon.

  2. Locate the Apply To setting and select Specific Products.

  3. Save your changes.

This adjustment allows you to set up broader or overlapping bundles without conflict. When done, you can create new bundles targeted for different product subsets or collections.

Best Practices for Managing Bundles

  • Use "all products" sparingly and only when absolutely necessary. Specific bundles provide better control and versatility.

  • Review existing bundles regularly to avoid errors or overlapping promotional conflicts.

  • Communicate bundle changes carefully to customers to prevent confusion in promotions.

  • Clearly define and separate product scopes when applying different promotions to ensure compliance with the "single promotion per product" rule.

By following these steps and rules, you can create and manage bundles in Atlas efficiently, ensuring smooth promotional campaigns without errors.

Did this answer your question?