Skip to main content

Merchandising rules (Pin / Hide / Boost)

Control product visibility for specific search queries using rule-based merchandising.

Written by Thomas Ta

Merchandising rules help you control which products shoppers see in search results-by pinning key products, boosting visibility, or hiding items entirely.


Merchandising strategies (and priority)

Merchandising strategies are applied in this priority order:

Hide > Pin > Boost

That means:

  • Hidden products will not appear (even if pinned/boosted elsewhere).

  • Pinned products will appear at the top (and override boosts).

  • Boost increases visibility within ranking when not pinned/hidden.


Global rules vs query-specific rules

  • Query-specific rule: Applies only to the search term(s) you define.

  • Global rule: Applies to all search terms.

⚠️ Note:

  • Global merchandising rule is prioritized over specific terms rules.

  • Only one global rule can exist for all search terms.


How to create a merchandising rule

  1. From app admin, go to Discovery > Merchandising

  2. Click Add new (or the equivalent create button)

  3. Configure:

    • Rule name

    • Search term(s) (or Global)

    • Strategy: Pin / Hide / Boost

    • Product selections

    • Active date range (if applicable)

  4. Save and enable the rule


Managing rules

From the rules list, you can typically:

  • Enable/disable rules

  • Edit rule configuration

  • Duplicate rules

  • Delete rules


Feel free to reach out to our dedicated support team via chat with any further questions.

Did this answer your question?