Skip to main content

​
Before you start

  • Ranking rules only affect text search results.
  • Each rule can be set to Active or Draft. Draft rules are saved but not applied to live searches.
  • You can create multiple rules and they all evaluate independently — if multiple rules match the same query, all of their actions are applied.

​
Choose a rule type

  1. Go to Ranking Relevancy and click the Rules tab.
  2. Click Create Rule.
  3. Choose a rule type:
    • Visual editor — Pin products to specific positions using a drag-and-drop grid. Best for curating results for high-value queries.
    • Manual rule — Boost or bury products based on attribute conditions and magnitude. Best for broad adjustments across many products.

​
Create a visual rule

  1. Enter a name for the rule.
  2. Type a search query — this is the query the rule targets. Products matching that query load into a grid.
  3. Drag products into the positions you want them to appear. Pinned products are locked to their assigned positions.
  4. To add a product not in the current results, use the search field within the grid to find and add it.
  5. Click Save to create the rule.
Visual rules use semantic targeting by default, so the rule also activates for queries that are semantically similar to the one you entered.

​
Create a manual rule

  1. Enter a name for the rule and set its status (Active or Draft).
  2. Choose a scope:
    • Global — The rule applies to every text search.
    • Query-specific — The rule only applies when the search query matches a condition you define.
  3. If you chose query-specific, configure the targeting condition:
    • Select a match type: Exact match, Contains, or Semantic match.
    • Enter the query value to match against.
    • For semantic match, adjust the similarity threshold slider (50–100%) to control how closely a query must relate to trigger the rule.
  4. Add one or more actions:
    • Choose Boost or Bury.
    • Select the product attribute to match (e.g., vendor, product type, tags).
    • Choose an operator and value.
    • Set the strength using the slider (1–50%, labeled Subtle to Strong).
  5. To add additional actions, click Add Action. You can combine multiple boost and bury actions in a single rule.
  6. Click Save to create the rule.

​
Manage existing rules

From the Rules tab, you can:
  • Enable or disable a rule using the toggle without deleting it.
  • Edit a rule to change its conditions or actions.
  • Duplicate a rule to create a copy with the same configuration.
  • Delete a rule permanently.

​
Tips

  • Use visual rules for your top search queries where precise product placement matters.
  • Use manual rules with global scope to apply broad adjustments, like boosting in-stock products or burying discontinued items across all searches.
  • Combine exact match targeting for high-volume queries with semantic match for long-tail variations.
  • Use the search preview on the signal weights page with ranking rules toggled on to verify rule behavior before going live.

​
See also