Overview
Attribute-based Bundle items use product information such as Category, Brand, Color, Custom Fields or Extracted Fields to decide which products are eligible for a Bundle.
You can combine up to three attributes in one item. Nosto first finds products that match the full attribute combination, then uses the Bundle type and shopper context to decide which matching products to show.
The Problem It Solves
One attribute can leave the eligible product pool too broad. For example, Category = Shirts may include products from every Brand, even when the Bundle should only show shirts from selected Brands.
Combining attributes lets you define that item as Category = Shirts AND (Brand = Adidas OR Nike). You no longer need to create a combined Custom Field for every possible attribute combination in your product data.
Creating a Multi-attribute Bundle Item
An item with one attribute continues to work as before. Add more attributes only when you need to narrow the eligible product pool further. You can also open an existing single-attribute item and add more attributes to it.
Open or create a Bundle in Dynamic Bundles.
In Setup → Bundle Items, open the attribute-selection modal for the item.
Select the first attribute from the left pane.
Configure its value or values in the right pane. Once all required values are set, the attribute appears under Selected.
Select and configure another attribute. Each completed attribute is added to the same item.
Repeat until the item contains the attributes you need, up to a maximum of three.
Set Number of products shown. This controls how many products Nosto can return for this item.
Select Add [number] attributes, and the combined item is added to the Bundle.
Adding Multiple Custom or Extracted Fields
Custom Field and Extracted Field keys are separate conditions. Add more than one key when a product must match several fields at the same time.
Select Custom Fields or Extracted Fields in the attribute list.
Select the first key, then one or more values. A product can match any of the selected values.
Select Add custom field or Add extracted field, and a new empty card appears.
Configure the next key and its values.
Add any other attribute conditions you need, up to the three-attribute limit for the item.
Each key can be used once per item. Each key counts as one of the three attributes. For example, Category plus two Custom Fields uses all three.
For example, combine Category: Shirts with the Custom Field gender: women or unisex. Nosto then only selects shirts whose gender Custom Field is women or unisex.
Understanding AND and OR Logic
Different Attributes Use AND
Every attribute in the item must match the same product.
For Category = Shirts AND Brand = Adidas, an Adidas product from a different Category does not match. A shirt from a different Brand does not match either.
Multiple Values Within One Attribute Use OR
When you select more than one value for the same attribute, a product can match any of those values.
For Category = Shirts AND (Brand = Adidas OR Nike), the product must be a shirt and its Brand can be either Adidas or Nike.
Multiple values still count as one attribute. The example above uses two of the three available attributes: Category and Brand.
Where Multi-attribute Matching Applies
You can use the same attribute combinations for:
Primary attribute-based Bundle items
Attribute-based fallbacks
Bundle triggers
Bundle deactivators
In the Bundle Builder, a combined item is labeled Multiple attributes. Hover over the label to see its attributes joined by AND, with multiple values of one attribute joined by OR.
Checking the Matching Products
Open Preview in the Bundle Builder.
Review the products returned for each multi-attribute item.
Confirm that each product matches every attribute condition in the item.
If the pool is too broad or too narrow, return to Setup → Bundle Items and adjust the selected attributes or values.
Changing the conditions only changes which products are eligible for that item. It does not convert the item into a fixed product or change the other items in the Bundle.
How Nosto Chooses From the Matching Products
The attribute combination defines the eligible product pool. Nosto then chooses from that pool based on the Bundle type and available shopper context. If there is no source product, some Bundle types fall back to best-selling products.
Triggered Bundles
Triggered Bundles always use a source product as the anchor for the recommendation:
On a Product Detail Page, the source is the currently viewed product.
On other page types, the source is taken from cart items, or otherwise from recently bought items.
Nosto uses the relationship score to select relevant products from the pool that matches all configured attributes.
Generic Bundles
Generic Bundles do not use a source product. Nosto selects best-selling products from the pool that matches all configured attributes. If a fixed product in the Bundle is marked Use for relations, it acts as the source for the attribute-based items instead.
For more information about the two Bundle types, see "Understanding Bundle Types and When to Use Them".
Summary
Attribute combinations: Add up to three attributes to define the eligible product pool for one Bundle item.
AND logic: Different attributes and Custom Field or Extracted Field keys must all match the same product.
OR logic: A product can match any of the selected values within one attribute.
Product selection: Triggered Bundles use a source product and relationship score, while Generic Bundles use best-selling products.
Existing Bundles: Single-attribute items continue to work as before.