Adding Rules

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

Conditions

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

• Examples: Price < $50, Product type = Jackets, or Tags = sale.

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 = The full merchandising strategy

Merchandising Controls

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

---

Application Scope

The available criteria come from the store's Shopify product data, including metafields, so the list varies by store. Common criteria include:

• Product attributes: Tags, vendor, product type, status, and collections (ID, handle, or title).
• Variant attributes: Price, compare-at price, inventory quantity, SKU, barcode, and options (such as size or color).
• Specific products: Individual Product IDs.

Each condition compares a criterion to a value. Operators include less than, more than, equals to, not equals to, between, more than percent, and less than percent.

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

• 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.

Tags

• Only Show Tags = summer → Only products tagged "summer" appear.
• Hide Tags = discontinued → Discontinued products are removed from view.
• Bury Tags = clearance → Clearance products sink to the bottom.
• Promote Tags = new-arrival → New arrivals rise to the top.

Collection & Product ID

• Collection
  • Only Show Collections - handle = mens-jackets
  • Hide Collections - handle = gift-cards
  • Bury Collections - handle = accessories
  • Promote Collections - handle = new-arrivals
• Product ID
  • Only Show Id = 123456
  • Hide Id = 789101
  • Bury Id = 222333
  • Promote Id = 999888

Inventory

• Only Show Variants - inventory quantity > 0 → Only in-stock products appear.
• Bury Variants - inventory quantity < 5 → Low-stock products sink to the bottom.

---

Precedence Order

Eligibility is always evaluated before ranking.

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

---

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): Product type = Accessories AND Price < $100
• Result: Only accessories under $100 are eligible.

OR Conditions Within One Rule

• Rule 1 — Promote
• Conditions (OR): Tags = new-arrival OR Vendor = Acme
• Result: Either new arrivals or products from Acme receive a boost.

Multiple Rules with AND (Eligibility + Blocking)

• Rule 1 — Only Show (AND): Product type = Jackets, Price < $180, Variants - inventory quantity > 0
• Rule 2 — Hide (OR): Tags = clearance, Tags = final-sale
• Result: Only in-stock jackets under $180 are eligible; however, any clearance or final-sale items are removed entirely.

Mixed Eligibility + Ranking (Layered Strategy)

This approach separates hard eligibility gates from soft ranking influence.

---

Saving & Testing

Once the logic is configured:

1. Save: The Component will appear in the Component Table.
2. Validate: Use the Playground to preview and validate the logic against real data before going live.