Skip to main content

​
Block rules

Rules allow you to modify block behavior based on contextual conditions and product attributes. Rules are evaluated in order, and the first matching rule’s actions are applied.

​
Targeting conditions

Targeting conditions evaluate context and product attributes. Available fields include: Anchor product attributes:
  • Product type
  • Vendor
  • Tags
  • Price
  • Any other product attribute
Contextual data:
  • Geographic location (country, state, city)
  • Customer tags
  • Device type
  • Marketing source, medium, and campaign

​
Rule actions

Add additional filtering to the block’s product results.Use cases:
  • Show only products from the same vendor as the anchor product
  • Filter by price range based on anchor product price
  • Show only products with specific tags
  • Apply geographic filtering (e.g., show winter products to cold climates)
Hide the block entirely when conditions are met. The fallback chain will be used instead.Use cases:
  • Hide “Frequently Bought Together” if anchor product is out of stock
  • Hide blocks for specific customer segments
  • Hide blocks on mobile devices
  • Hide blocks for specific geographic regions
Switch to a different strategy when conditions are met.Use cases:
  • Use “Similar Products” for mobile users instead of “Frequently Bought Together”
  • Switch to different interaction strategies based on customer segment
  • Use different strategies for different product types
Modify the block’s safeguards (min/max products, hide out of stock) based on conditions.Use cases:
  • Show more products for VIP customers
  • Adjust minimum products based on device type
  • Enable/disable out-of-stock filtering based on inventory levels

​
Multiple rules

You can configure multiple rules for a single block. Rules are evaluated in order, and the first matching rule’s actions are applied.

​
Safeguards

Safeguards ensure blocks display appropriately and provide a good customer experience.

​
Hide out of stock

Automatically filter out products that are not available for purchase. Behavior:
  • Products with unavailable status are excluded from results
  • Applies after strategy execution but before pagination
  • Can be overridden by rules

​
Minimum products

If the block returns fewer than the minimum number of products, the fallback chain is used instead. Behavior:
  • Evaluated after filtering and safeguards are applied
  • If results are below minimum, the system tries the first fallback block
  • If no fallback blocks are configured, the block returns the available products
  • Prevents displaying blocks with too few recommendations
Use cases:
  • Ensure “Frequently Bought Together” always shows at least 4 products
  • Maintain consistent block appearance across pages
  • Automatically fall back to curated collections when behavioral data is insufficient

​
Maximum products

Limits the total number of products returned by the block across all pages. Behavior:
  • Applied after all filtering and sorting
  • Caps the total result set to the specified maximum across all pages
  • totalResults and totalPages reflect the capped total, ensuring consistent pagination metadata
  • Pages beyond the cap return empty results
Use cases:
  • Limit recommendations to fit specific UI layouts
  • Control page load performance
  • Maintain consistent block sizes

​
See also