Adding Rules

Components use a Rules → Conditions hierarchy to determine exactly which products surface to your customers.

Conditions

A Condition is a single, atomic check against your product catalog.

• Examples: Price < $50, Category = Jackets, or Margin > 20%.

Rules

A Rule acts as a container for one or more Conditions.

• Conditions within a single Rule can be combined using AND / OR logic.

Multiple Rules

Rules themselves are combined with AND logic.

---

Logic Summary

To help visualize the hierarchy:

• Condition = Atomic check
• Rule = Logical group of conditions
• Multiple Rules = Your full merchandising strategy

Merchandising Controls

Each Rule applies one control type that determines how matching products behave within the strategy.

---

Application Scope

These controls can be applied to a wide variety of data points, including:

• Catalog Attributes: Themes, margins, inventory levels, or star ratings.
• Specific Identifiers: Individual Product IDs (SKUs).
• Business Logic: Any custom attribute defined in your product feed.

Note: If a product is targeted by both an Only Show rule and a Hide rule, the Hide rule takes precedence and the product will be removed.

---

Condition Examples by Attribute

Below are common configurations for applying merchandising logic across different product attributes.

Price & Margin

• Price
  • Only Show Price < $50 → Only budget products appear.
  • Hide Price > $200 → Luxury items are removed from view.
  • Bury Price > $150 → Higher-priced items sink to the bottom.
  • Promote Price < $40 → Entry-level items rise to the top.
• Margin
  • Only Show Margin > 20% → Focus exclusively on profitable inventory.
  • Hide Margin < 5% → Automatically remove unprofitable items.
  • Bury Margin < 15% → Reduce visibility for thin-margin products.
  • Promote Margin > 35% → Aggressively boost high-profit items.

Collection & Product ID

• Collection (Taxon)
  • Only Show Taxon = Men’s Jackets
  • Hide Taxon = Clearance
  • Bury Taxon = Accessories
  • Promote Taxon = New Arrivals
• Product ID (SKU)
  • Only Show Product ID = 123456
  • Hide Product ID = 789101
  • Bury Product ID = 222333
  • Promote Product ID = 999888

Theme

• Only Show Theme = Summer Collection
• Hide Theme = Holiday Specials
• Bury Theme = Flash Sale
• Promote Theme = Limited Edition

---

Precedence Order

Eligibility is always evaluated before ranking.

1. Hide (Highest priority - if it's hidden, other criteria will not apply)
2. Only Show (Applies inclusion filter)
3. Pin (Overrides ranking rules)
4. Promote / Bury (Final ranking adjustments)

[!IMPORTANT] An item must pass all Hide and Only Show checks before Pin, Promote, or Bury rules are applied.

---

Grouping Rules & Conditions — Examples

The power of the strategy engine lies in combining multiple rules and conditions. Here is how logic translates to results:

Simple AND Rule

• Rule 1 — Only Show
  • Conditions (AND): Category = Women’s Accessories AND Price < $100
• Result: Only women’s accessories under $100 are eligible.

OR Conditions Within One Rule

• Rule 1 — Promote
  • Conditions (OR): Theme = New Arrival OR Margin > 40%
• Result: Either new arrivals or very high-margin items receive a boost.

Multiple Rules with AND (Eligibility + Blocking)

• Rule 1 — Only Show (AND): Category = Men’s Jackets, Price < $180, Inventory > 0
• Rule 2 — Hide (OR): Theme = Clearance, Margin < 8%, Product Rating < 3 Stars
• Result: Only in-stock men’s jackets under $180 are eligible; however, any items that are clearance, low-margin, or poorly rated are removed entirely.

Mixed Eligibility + Ranking (Layered Strategy)

This approach separates hard eligibility gates from soft ranking influence.

---

Saving & Testing

Once you have configured your logic:

1. Save: The Component will appear in your Component Table.
2. Validate: Use the Playground (as detailed at the top of this guide) to preview and validate the logic against real data before going live.