📖 Merchandising rules for Search give you precise control over how products appear across search results, making it easy to set rules for product positioning and deliver a better shopping experience.
Overview
The Overview page displays all rules that apply to the Instant Search widget and search results pages. Here you can organize your rules, see what they are doing, edit existing rules, and create new ones.
On this page you can:
Enable or disable rules by switching the toggle.
View how a rule is affecting your site.
Spot global rules and expired rules. A star icon marks the rule that applies to all search terms.
See which strategies are active. Each rule shows icons for its merchandising strategies. Active ones are highlighted. Hover over an icon to see what that strategy does.
Merchandising strategies
Clearer lets you create up to 5 merchandising strategies.
💡 The strategies are set in priority order (highest to lowest): Hide > Banner > Pin > Demote > Boost
Strategy | What it does | Example use case |
Hide | Removes products from search results and collection pages entirely, based on attributes you choose. | Hide out-of-season items or products with low engagement. |
Banner | Displays an on-site image linking to a product or landing page. | Highlight a campaign or drive cross-sells with a visual call-out. |
Pin | Fixes one or more products at the top of search results or a collection. You can also pin whole groups of products by tag to create repeating grid layouts. | Keep your best-margin items always visible, or build a mosaic-style tiled layout. |
Demote | Pushes lower-performing products further down the results. | Deprioritize items with poor reviews or low conversion rates. |
Boost | Moves products up in organic results based on attributes like price, vendor, or tags. | Surface high-margin products more prominently without pinning them in place. |
Creating rules for specific search terms
⚠️ This rule will affect the search results in the Instant Search Widget and Search Results pages.
Step 1: Click the "Add new rule" button
From the app's admin, go to Product Discovery > Rules > Search rules > click Add New.
Step 2: Set rule conditions
Rule name: You must enter a name for the rule.
Active date: You can optionally set the validity period of the rule by clicking the date range box.
Assigned segment: Choose how you want to target the rule to a specific segment. If you do not make any adjustments, the field is set to All shoppers by default.
Apply to: Select the Specific search queries option.
One search term (query) can be included in one rule only. However, you can add multiple search terms to one rule.
By understanding how customers search for products in their store, you can add relevant search terms to your rules and optimize the impact of the rule on search results.
For example, if you run an online store that sells clothing and accessories, you might want to prioritize new dress products in search results. To do this, create a rule that targets specific search terms such as "women dress", "skirt", and "dress". When customers enter one of these search terms in your store's search box, the rule is triggered and the corresponding products are prioritized in the search results.
Step 3: Set merchandising strategy
You can apply up to 5 merchandising strategies (Pin, Hide, Demote, Boost, Banner) to a rule that applies to specific search terms. The settings for each strategy you select appear on the right side of your screen.
💡 The strategies are set in priority order (highest to lowest): Hide > Banner > Pin > Demote > Boost
Pinning products
You can pin up to 20 products in the first 20 positions for the Instant Search widget and search results pages.
⚠️ This rule only works when you enable Relevance sorting on search results pages.
Drag and drop each product to the desired position. Pinned products are highlighted with a pinning icon in the preview section. You can un-pin a product and return it to its original position by removing the pinning setting.
The setting Pinned products must be matched with customer's active search query to display is checked by default. This means products are only pinned if they are included in the search results for the terms you set.
Example: You create a rule with the search term "dress" and pin product A. A customer searches "dress", and product A does not belong to the returned results. If you check the box, product A is not pinned. If you uncheck the box, product A is always pinned, even though it is not in the returned results.
Hiding products
This rule lets you hide up to 7 products that have low sales or engagement, are seasonal or temporary, or are out of stock, from appearing in the commerce search.
💪 This rule is effective for all types of sorting on the search results pages.
Under the Hide product section, set up the conditions for hiding by deciding which product attribute activates the rule. You can add a maximum of seven sets of conditions and seven product attributes for each condition.
Click + Add attributes to add a new condition.
Click + Add condition when you want the rule to have multiple sets of conditions.
Boosting products
Moves products matching certain attributes to the top of organic results. Boost re-evaluates in real time, so results stay current even as product data changes.
⚠️ This rule only works when you enable Relevance sorting on search results pages.
Set up to 3 condition sets, each with up to 3 attributes. Use + Add for another attribute, or + Add another set of conditions for an additional condition set. Products matching all conditions in a set rise to the top of both the Instant Search widget and the results page.
Example: Boost black dresses from Mango priced under $500 by setting three conditions within one condition set: color = black, vendor = Mango, price < 500.
In preview, boosted products appear at the top, followed by any pinned products.
Demoting products
Pushes matching products further down the results. Useful for out-of-stock or underperforming items you do not want to hide entirely.
⚠️ This rule only works when you enable Relevance sorting on search results pages.
Same structure as Boost: up to 3 condition sets, 3 attributes each, using + Add and + Add another set of conditions.
Banner
Adds an on-site image that links to a product or landing page, placed directly in the results grid.
To set one up:
Position: Banners default to the first slot in the product list. You can move them anywhere from position 1 to 6.
Name: Give the banner a name for your own reference.
Image: Upload a
.jpg,.jpeg, or.pngfile, max 2MB. The banner renders using your theme's product-card layout, including the image and info areas.Redirect link: Set the URL the banner should send shoppers to.
Open in new tab: Optional checkbox if you would rather keep your store open in the background.
Once configured, the banner appears in the rule's summary alongside your other strategies. Use View the banner on your store to preview it live.
Step 4: Review & Finish
To create a rule for your front store, click Review & Publish and check that your settings are correct. Once you have confirmed everything, select Publish to enable and apply the rule immediately.
If you need to make further adjustments before publishing, choose Save as draft. The rule is not enabled and does not apply to your store until you enable it later.
Creating rules for all search terms
A global rule supports 3 strategies: Boost, Demote, and Hide, resolved in this order: Hide → Demote → Boost
By applying the global rule for all search terms, any products that match the conditions are boosted, demoted, or hidden as long as they are included in the search results when shoppers search on your store.
Step 1: Click the "Add new rule" button
From the app's admin, go to Discovery > Merchandising > click Add New.
Step 2: Set rule conditions
Rule name: You must enter a name for the rule.
Active date: You can optionally set the validity period of the rule by clicking the date range box.
Apply to: Select the All search queries option. This means the products that match this rule are always displayed in the search results, regardless of the terms your customer enters in the search bar.
Example: You are running a sales campaign to promote products priced below $50. Enabling this global rule for all search terms with the Boost strategy ensures these products are consistently promoted and displayed at the top of the search results for any search term used by shoppers in your store.
The global merchandising rule is prioritized over rules for specific terms.
You can create ONLY ONE rule for all search terms.
Step 3: Set merchandising strategy
Boost: Matching products stay at the top of results for every search term, re-evaluated in real time.
Requires Relevance sorting to be enabled. Up to 3 condition sets, 3 attributes each.
Demote: Matching products consistently rank lower, for every search term.
Requires Relevance sorting to be enabled. Up to 3 condition sets, 3 attributes each.
Hide: Matching products are removed from results entirely, for every search term.
This rule is effective for all types of sorting on the search results pages. Up to 7 condition sets, 3 attributes each.
Step 4: Review & Finish
To create a rule for your front store, click Review & Publish and check that your settings are correct. Once you have confirmed everything, select Publish to enable and apply the rule immediately.
If you need to make further adjustments before publishing, choose Save as draft. The rule is not enabled and does not apply to your store until you enable it later.
Manage/Edit merchandising rules
To modify a rule you have created, select the name of the rule or click Edit in the Actions column.
Review and update the rule information as needed, such as the rule name, date range, and conditions.
To delete a rule you have created, click the Delete icon in the Actions column and confirm on the popup to remove the rule.
Feel free to reach out to our dedicated support team via chat with any further questions.







