Smart Search Recommendation: Configuring Default Filters
The Filters 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 filter, 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. For details, see the section "Leveraging Metafields for Personalized Filtering" in this article.) | |
| Single-line text |
Supports filtering by single-value and multi-value single-line text metafields. This can be used to create product attribute filters, such as "Product Style: Minimalist, Vintage" or "Usage Scenario: Commuting, Sports." |
| Boolean |
Supports filtering by boolean (Yes/No) metafields. This can be used to create simple binary filter conditions, such as "Eco-friendly Material" or "Limited Edition Product." |
| Whole number |
Supports single-value and multi-value whole number metafields. This is suitable for numeric attributes, such as "Warranty: 2 years" or "Capacity: 2, 4 people." |
| Decimal |
Supports single-value and multi-value decimal metafields. This is suitable for precise specifications, such as "Capacity: 1.5 L" or "Weight: 1.2 kg, 1.5 kg." |
How to Configure a Filter Condition
To add and configure a new filter condition:
- Go to Smart Search Recommendation > Filters > 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
The Filter value section controls how values under a filter condition appear to customers. Depending on the filter type, you can show values, search values, hide or display values, change value order, group values, or import and export values.
Filter Value Tools by Filter Type
Use the following table to understand which tools are available for each supported filter type:
| Filter Group | Filter Type | Supported Filter Value Tools | Admin Value Display Limit |
| Product | Tag | View, search, show/hide, sort (auto/manual) | Up to 1,000 values |
| Product type | View, search, show/hide, sort (auto/manual) | Up to 1,000 values | |
| Manufacturer | View, search, show/hide, sort (auto/manual) | Up to 1,000 values | |
| Category tree | View, search, show/hide | Up to 500 values | |
| Variant list | All variant options (e.g. Color, Size, Material) | View, search, show/hide, sort (auto/manual), group filters, import/export | Up to 10,000 values |
| Metafields | All custom metafields | View, search, show/hide, sort (auto/manual), group filters | Up to 1,000 values |
|
Note: The value limits shown in the table above refer to the maximum number of filter values displayed in the admin panel. On the storefront (customer-facing side):
|
Grouping Filter Values
For Variant List and Metafields filters, you can group multiple related values together to create broader, more meaningful filter options. This helps shoppers find products that share similar attributes. 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: Different filter types support different management tools. For a detailed breakdown, refer to the "Filter Value Tools by Filter Type" section above. |
| Button | Description |
| Search filter values | Use the search bar to quickly locate specific filter values. |
| Hide filter values | Temporarily hide selected filter values from appearing in the storefront filter list. You can also turn off the eye icon next to each value to hide them individually. |
| Display filter values | Make hidden filter values visible again. You can also turn on the eye icon next to each value to display the value. |
| Filter value sorting | Choose how filter values are ordered: Automatic sorting (system-defined) or Manual sorting (customize the display order based on your preference). |
| 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 metafields to create custom filter options. The system supports multiple metafield types — including single-line text, boolean, whole number, and decimal — allowing customers to filter products using more intuitive attribute 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 a supported type based on your filtering needs, such as:
- Single-line text (Single-value / Multi-value)
- Boolean
- Whole number (Single-value / Multi-value)
- Decimal (Single-value / Multi-value)
- 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:
|