Narrow Down Items in Dynamic Lists Using Filter
You can use filters to refine which CMS items are shown in a dynamic list by setting conditions based on properties you’ve assigned to those items. This article explains which properties are available for filtering and how to set them up to display exactly what you need in your list.
Point: What are Dynamic Lists?
Dynamic lists let you display lists that reference data both inside and outside Studio.Design. You can connect content managed in Studio CMS, or data sourced from external services via API or RSS, and display the results as a list on your site.
For more details, see What is Dynamic List.
What is a Filter?
Filters help you control which items appear in a dynamic list. You set filter conditions based on [Properties] configured in the CMS dashboard ahead of time. You can apply more than one filter to narrow your results even further. Filters can only be set for dynamic lists tied to CMS models.
Example Setup:
Let’s say you want a list showing only “Dresses” from your product model that cost at least ¥5,000.
Filter setup in Dynamic List:
Use the Number Property for “Price”
Use the Select Property for “Product Category”
Properties Available for Filtering
You can configure filter criteria using the following CMS Properties or by entering keywords into the search bar (keywords can only be used on the Search Page). You can also combine multiple criteria to refine your filters further.
Filter Types and How They Work
Filter Type | How You Can Filter | Usage Notes |
Filter based on numeric values, using any of the following conditions:
|
| |
Filter by “On” or “Off” status |
| |
Specify exactly one value to filter |
| |
Specify one or more values to filter | Can set up to 5 filter values | |
Reference Property/ Single-select | Specify one value to filter |
|
Reference Property/ Multi-select | Specify one or more values to filter | Can set up to 5 filter values |
Search Keyword | Filter by keywords entered in the search form | Only works when using the Search Page |
Properties That Cannot Be Used as Filters
The following properties cannot be used for filtering:
Published Date
Last Edited
How to Set Filter Conditions
Note: Support won’t be able to assist with individual filter setups or combining filter conditions, per the [Studio Support Policy].For system issues, please log in and click the [?] chat support at the bottom right.
Before You Start Adding Filters, Make Sure:
You have a [Dynamic List] set on the page in the editor.
The [Properties] to be used for filtering are defined in the CMS dashboard.
Steps
Open the [Layer Panel] on the page where your dynamic list is placed.
Open the left panel and choose the [Layers] tab, or select the layer icon in the lower left.
Select your dynamic list from the layers.
Lists are shown with an icon of four squares. You’ll see the list outlined in light blue in the editor.
When a data-linked list (dynamic list) is selected, you’ll see data settings in the left panel.
If your list isn’t linked to data yet, set it up by clicking [Connect data] button.
If the filter option isn’t visible in the data settings, check your model settings. Lists connected to a Collection cannot be filtered.
In your data panel, click [Filter] and then [+] to add properties and specify filter criteria.
You can add up to five filters.
Only AND conditions are supported—multiple filters will all apply. OR conditions are not available.
Visitors to your site cannot filter list content using multiple conditions.
![Screenshot: click [Filter] and then [+] to add properties and specify filter criteria.](https://downloads.intercomcdn.com/i/o/xqogzym4/1694945927/abee1eb8df853fbc3cc414ff5400/image+%2837%29.png?expires=1756404000&signature=56479aa9962a2d76d3dc6b489e4addcac1d0b8f2e62229e8985f16d4ca5ca6c1&req=dSYuEsB6mIhdXvMW3nq%2BgVaxQ9ael9AC1CHD4USPBohbidv5PC1f9%2BzxPaeO%0AaBj8mBYCAiNFIju%2FLqrfAvTcM6A%3D%0A)
In the Publish panel, select [Update Site]. (Use this if you’ve made changes to your published site.)
If you’re editing a published site in the Design Editor, you must complete this step. Otherwise, the updates you made in the Design Editor won’t appear on your live site.
Check that your filter conditions work as intended in both the editor and live preview.
Note: If Filters Don’t Work as Expected on the Live Site
Items with a status other than [Published] will not appear.Check CMS Item Publish Status in the CMS dashboard.