This example allows an eligible item to be bundled only with products specified as "Items that can be bundled." Use it when you want customers to purchase replacement filters or optional accessories only together with their corresponding main product.
Prerequisite: The initial setup for bundle limits must be complete. If you haven't done this yet, see "Initial Setup (Bundle Limits)".
When the bundle rule is enabled, whenever the cart contains an eligible item, it checks whether the other items in the cart match "Items that can be bundled."
Eligible items only (even multiple types): purchase is allowed.
Eligible item + a product specified as "Items that can be bundled": purchase is allowed.
Eligible item + any other product: purchase is not allowed.
Only products specified as "Items that can be bundled," or combinations with other products: purchase is allowed (the specified products themselves are not restricted).
Note: Items specified as "Excluded items" are treated as neither eligible items nor non-eligible items, and are not included in the bundle evaluation.
(1) Create a bundle rule
Open the app admin → "Bundle rules" → "Create rule".
(2) Enter the settings
Configure the following.
Field | Value |
|---|---|
Title | Any internal title |
Bundle limit level | Bundle only with specific items → Selected items |
Eligible items | Products to restrict (e.g., replacement filters) |
Items that can be bundled | Products allowed to be bundled (e.g., the corresponding main product) |
Excluded items | Set if needed |
Product message | Enter if needed |
Display timing | Cart updated and checkout |
Alert message | Enter if needed |
Note: For this bundle limit level, you cannot specify "All items" as the eligible items. Specify them using a specific collection, specific products, or products with a specific tag.
(3) Save and enable the bundle rule
After saving the settings, select "Enable." Saving alone does not apply the bundle limit.
(4) Check the behavior
Check the result when the cart is updated and at checkout, both with the eligible item and an "Items that can be bundled" product together in the cart, and with the eligible item and any other product.
If you specify the same product as both an eligible item and in "Items that can be bundled," a warning is displayed. Duplicated products are treated as eligible items and are not counted as bundle partners.
To exclude only some of the eligible items from the restriction, specify them as "Excluded items."
Variables cannot be used in the product message or alert message for bundle rules.