Skip to main content
Sort Orders

​
Steps

  1. Go to Sort Orders and click Create.
  2. Add simple rules (like newest or price) or combine a few signals.
  3. Give it a clear name so your team knows when to use it.
  4. Save your sort order.

​
Sorting Attribute Types

​
Simple Attributes

Sort by product attributes like price, title, or sales metrics. These are the most common sorting rules.

​
Priority Rules

Boost or demote products matching specific conditions. Priority rules cluster matching products at the top or bottom of results based on their position in the sort order:
  • First position: Promotes matching products to the top (DESC ordering)
  • Other positions: Demotes matching products to the bottom (ASC ordering)
Available operators: Text operators:
  • equals / does not equal - Exact match
  • contains / does not contain - Partial text matching
  • begins with / does not begin with - Prefix matching
  • ends with / does not end with - Suffix matching
  • in / not in - Match any value in a list (enables multi-select)
  • is null / is not null - Check if attribute has a value (hides value field)
Numeric operators:
  • equals / does not equal - Exact numeric match
  • greater than / greater than or equal - Value comparisons
  • less than / less than or equal - Value comparisons
  • between / not between - Range matching (requires two values)
  • in / not in - Match any value in a list (enables multi-select)
  • is null / is not null - Check if attribute has a value (hides value field)
Date operators:
  • equals / does not equal - Exact date match
  • after / before - Date comparisons
  • between / not between - Date range matching (requires two values)
  • is null / is not null - Check if attribute has a value (hides value field)
Tag operators:
  • contains / does not contain - Check if tag exists
  • in / not in - Match any tag in a list (enables multi-select)
Examples: Promote scenario - Priority rule in first position: 
1. Priority Rule: vendor equals "Nike"
2. Sort by: Sales (7d) - Descending
Result: All Nike products appear first, then remaining products sorted by sales. Demote scenario - Priority rule in last position: 
1. Sort by: Title - Ascending
2. Priority Rule: vendor equals "Nike"
Result: Non-Nike products appear first (sorted by title), then Nike products at the bottom. Multi-value selection - Using in or notIn operators: When you select the in or notIn operator in the UI, multi-select functionality is automatically enabled, allowing you to select multiple values in a single rule. 
1. Priority Rule: vendor in ["Nike", "Adidas", "Puma"]
2. Sort by: Sales (7d) - Descending
Result: All products from Nike, Adidas, or Puma appear first, then other brands sorted by sales. 
1. Priority Rule: tags in ["featured", "bestseller", "new-arrival"]
2. Sort by: Price - Ascending
Result: Products with any of the specified tags appear first, sorted by price, then remaining products. Null operators - Check if attributes are set: When you select is null or is not null, the value field is automatically hidden since these operators check for presence/absence of data. 
1. Priority Rule: compare_at_price is not null
2. Sort by: Discount Percentage - Descending
Result: Products on sale (with compare-at price set) appear first, sorted by discount. 
1. Sort by: Sales (7d) - Descending
2. Priority Rule: inventory_quantity is null
Result: Products with inventory tracking appear first, products without tracking at the bottom. Range exclusion - Using not between: 
1. Sort by: Sales (7d) - Descending
2. Priority Rule: variant_price not between [100, 200]
Result: Products priced outside 100−100-200 appear first, products in that range at the bottom.

​
Weighted Groups

Combine multiple attributes with different weights to create sophisticated ranking algorithms.

​
Soft Boost (Beta)

Apply a decaying multiplier to boost products matching conditions while maintaining natural ranking. Unlike priority rules, soft boost creates interleaving rather than clustering.
Soft boost is currently in beta. To join the beta program, contact your account manager or support team.
Key differences from priority rules:
  • Natural interleaving: Boosted products are distributed throughout results based on their base score
  • Decaying multiplier: Products with lower base scores receive larger relative boosts
  • Requires following attribute: Soft boost must be followed by another sort attribute to modify
Configuration:
  • Attribute: The product attribute to check (e.g., tags, vendor, options)
  • Operator: Condition operator (see available operators below)
  • Value: The value to match (multi-select available for in and notIn operators, hidden for is null and is not null)
  • Boost Mode: Choose between multiplicative (default) or additive mode
    • Multiplicative: Multiplies base value by a boost factor (requires non-zero base values)
    • Additive: Adds a percentile-based value (works even when base value is 0)
  • Boost Strength (multiplicative mode only): Intensity of the boost (default: 0.25, range: 0-10)
  • Percentile Target (additive mode only): Target percentile for boosted products (default: 50, range: 0-100)
  • Decay Rate: How quickly the boost diminishes (default: 100, range: 1+)
Available operators for soft boost: All the same operators available for priority rules can be used with soft boost, including:
  • Text operators: equals, does not equal, contains, does not contain, begins with, does not begin with, ends with, does not end with, in, not in, is null, is not null
  • Numeric operators: equals, does not equal, greater than, greater than or equal, less than, less than or equal, between, not between, in, not in, is null, is not null
  • Date operators: equals, does not equal, after, before, between, not between, is null, is not null
  • Tag operators: contains, does not contain, in, not in
Example (Multiplicative): Boost products tagged “featured” while sorting by sales: 
1. Soft Boost: tags contains "featured" (Boost Mode: Multiplicative, Boost Strength: 0.5, Decay Rate: 100)
2. Sort by: Sales (7d) - Descending
Example (Additive): Sprinkle new arrivals with zero sales into best sellers: 
1. Soft Boost: tags contains "new-arrival" (Boost Mode: Additive, Percentile Target: 75, Decay Rate: 500)
2. Sort by: Sales (7d) - Descending
Example (Multi-value): Boost products with any of multiple tags using in operator: When you select the in or notIn operator in the UI, multi-select is automatically enabled. 
1. Soft Boost: tags in ["featured", "bestseller", "trending"] (Boost Mode: Multiplicative, Boost Strength: 0.5, Decay Rate: 100)
2. Sort by: Sales (7d) - Descending
When to use additive mode:
  • Boosting products with zero or near-zero base values (new arrivals with no sales)
  • Creating a specific target position in the sort order
  • “Sprinkling” new products into established rankings
Soft boost cannot be the last sorting attribute. The dashboard will show a validation error if you attempt to save a sort order with soft boost as the final attribute.
Learn more about soft boost in the Sort Orders documentation.

​
Tip

  • Start simple. You can refine weights over time.
  • Use soft boost for subtle promotion that maintains organic ranking.