Smart Search Recommendation: Configuring Default Filters
The Filter section in the Smart Search Recommendation app allows merchants to create and manage filters that help shoppers narrow down search results on the storefront. By configuring filters effectively, customers can find their desired products faster, improving product discoverability and overall shopping experience.
This article explains how to configure the settings in Default filters, which define the standard filtering conditions applied across all collection pages and the search results page.
Supported Filter Conditions
Default filters support a variety of filter conditions that determine how customers can refine product search results. The following table lists all available filter types and conditions:
| Filter Condition | Description |
|
Product (Product-related filter conditions are system presets and can be directly applied as needed.) |
|
| Price | Allows customers to filter products by selling price range at the SKU level. |
| Availability |
Lets customers choose to view only in-stock products. The system considers a product as in stock under the following conditions:
|
| Tag | Filters products by product tags — particularly useful for campaign-specific filtering. |
| Product Type | Filters products by predefined custom product types. |
| Manufacturer | Displays filters based on manufacturer or brand information. |
| Category Tree |
Uses the category hierarchy defined in your product category tree as a filtering condition, allowing customers to browse by category levels. Note: This feature is currently available only to whitelisted users. To enable access, please contact SHOPLINE Support. |
|
Variant List (Variant List options automatically sync with the variants configured in the product settings page. The following are some common examples.) |
|
| Color | Displays color-based filtering options configured under product variants. |
| Size | Enables filtering by product size attributes (e.g., S, M, L). |
| Material | Allows filtering by product material attributes (e.g., cotton, linen, genuine leather). |
|
Metafields (To use Metafields as filtering conditions, you must first complete the configuration on your admin panel.) |
|
| Single-line text metafields |
Supports filtering by single-value and multi-value single-line text metafields, enabling more flexible grouping and personalized filtering. Note: To use this type of filter, you must first create the corresponding metafield in your Admin. For details, see the "Leveraging Metafields for Personalized Filtering" section of this article. |
How to Configure a Filter Condition
To add and configure a new filter condition:
-
Go to Smart Search Recommendation > Filter > Default filter.
-
Click Add filter condition or Add a filter item.
-
In the Filter options card, select a Filter type from the dropdown list. You can search or scroll through available filter types (e.g., Price, Color, Product Type).
-
Enter a custom name in the Filter type name field — this is the label displayed on the storefront.
-
Manage Filter values based on the selected filter condition. For more details, refer to the "Managing Filter Values" section.
Note: Some filter conditions have predefined values and cannot be manually configured.
- Click Add to apply.
Managing Filter Values
For the Variant List filter type, such as Color and Size, an additional Filter value setup section is available. Here, you can manage, group, or adjust how filter values appear in the storefront to make these filters more intuitive and inclusive.
Grouping Filter Values
You can group multiple related values together to create broader, more meaningful filter categories. This helps shoppers find products that share similar attributes and expands the range of search results. For example:
- Color: Group "Navy," "Royal," and "Sky Blue" under Blue.
- Size: Group "XS," "S," and "Small Petite" under Small.
To group values:
-
Select two or more similar filter values from the list, then click Create filter group.
-
Enter a group name (e.g., Blue), then click Create to save your changes.
|
Tip: After creating a group, you can use Add to filter group to include additional values in the existing group, or Ungroup filter group to separate the grouped values. |
Other Management Tools
Within the same Filter value section, you can use additional tools to control how values are displayed and managed:
| Note: Only filter conditions that include the Filter value setup (such as Color or Size) display these management tools. |
| Button | Description |
| Hide filter values | Temporarily hide selected filter values from appearing in the storefront filter list. |
| Display filter values | Make hidden filter values visible again. |
| Import / Export | Bulk upload or download filter values for faster setup — ideal for large catalogs with many color or size variations. |
|
Notes:
|
Leveraging Metafields for Personalized Filtering
To provide a more precise and flexible product filtering experience, you can use single-line text metafields to create custom filters. This feature allows products to carry multiple attributes under one metafield (e.g., a ring made of "Gold-plated and Sterling Silver"), helping shoppers discover products through more intuitive combinations.
Step 1. Create a Metafield Definition
-
Go to your SHOPLINE admin panel > Settings > Customize data.
-
Under the Metafield list, select Product.
-
Click Add fields.
-
On the Add product metafield definitions page, fill in the following details:
- Field Name: Enter a clear name for easy management, such as "Product Filter."
- Namespace: Enter a unique namespace.
- Key: Enter a unique key.
- Description (Optional): Provide additional context for internal reference if needed.
- Data Type: Select Single line text.
- Assignment Type: Select Single value or Multiple values according to your setup needs.
-
Access options: If Multiple values is selected, you must check Supports custom product filters so the metafield can be used in Smart Search Recommendation.
Note: If the Supports custom product filters checkbox is not checked during setup, the metafield will not appear in the Smart Search Recommendation app, even if it has been correctly configured on the product pages. If you later wish to enable this metafield as a filter condition, you must not only check Supports custom product filters, but also reconfigure the metafield on all associated products for proper detection and use in the app.
-
Click Add to save the metafield.
Step 2. Assign Metafield Values to Products
Once the metafield is created, you need to apply it to your products.
-
Go to Products, select a desired product, and open its product detail page.
-
Scroll down to the Product metafields section and find the metafield you just created (e.g., Product Filter).
-
Add one or more values for the product — for example:
-
- Best Seller
- New Product
- On Sale
-
-
Click Update to apply the changes.
-
Repeat the above steps for all desired products.
| Tip: Each product can include multiple values. For example, a product can be both "Best Seller" and "On Sale" to appear in multiple filter categories. |
Step 3. Add the Metafield as a Filter in Smart Search Recommendation
After setting up metafields in Admin, you can now use them to build filters in the Smart Search Recommendation app.
-
Go to Smart Search Recommendation > Filter > Default filter.
-
Click Add filter condition.
-
In the Filter type dropdown, scroll to the Metafields section — newly created metafields will appear here automatically. Select the desired metafield as your filter type.
-
Give it a clear name such as Product Highlight. This name will be visible to your customers.
-
Configure filter values and group them if needed. For detailed instructions, refer to the "Managing Filter Values" section of this article.
-
Click Add to save your settings.
Managing Filter Conditions
Once your filters are created, you can manage and maintain them easily. The table below lists the available features you can use to manage existing filter conditions:
| No. in Screenshot | Feature | Description |
| 1 | Activate / Deactivate | Toggle each filter on or off to control its visibility on the storefront. |
| 2 | Reorder filters | Drag and drop filters to adjust their display order. |
| 3 | Delete | Click the trash icon to remove unnecessary filters. |
| 4 | Add / Edit Filter Conditions | Click Add filter condition to create a new condition, or select any existing condition to edit and update it. |
| 5 | Display Settings | Click Display settings to customize how filters appear in your storefront’s sidebar or top bar. |
|
Notes:
|