What is a Dynamic Filter?
A Dynamic filter automatically narrows down the items displayed in a CMS List placed on a dynamic page, based on the CMS item currently being displayed on that page.
Unlike standard filters, the filter value automatically changes for each page. This makes it easy to create pages like category-based article lists or related article lists.
Point: What is a CMS List?
A CMS List is a type of dynamic list that references data from inside or outside Studio.Design and displays it on your site — specifically, one that is linked to internal content data from Studio CMS.
You can also dynamically edit the list based on CMS properties you've set up in advance.
Requirements for setting up a Dynamic Filter
You can set up a Dynamic filter when all of the following conditions are met:
A CMS List is placed on a dynamic page.
The filter condition uses a reference property (single select or multi select).
The dynamic page, CMS List, and the reference property used in the filter condition correspond to CMS models that match one of the following patterns:
Pattern 1: The CMS model of the dynamic page matches the CMS model referenced by the property.
Example:
Dynamic page model: Category
CMS List model: Article
Filter condition property: "Category" within the Article model (a reference property that references the Category model)
Pattern 2: The CMS model of the dynamic page matches the CMS model of the CMS List.
Example:
Dynamic page model: Article
CMS List model: Article
Filter condition property: "Category" within the Article model (a reference property that references the Category model)
Setting up a Dynamic Filter
Note: About contacting our support team
In accordance with the Studio Support Policy, our support team is unable to provide guidance on individual setup methods or consult on how to combine filter conditions.
If you suspect a bug, please log in to Studio.Design and contact our chat support via the [?] icon in the bottom-right corner.
Preparation 1: Design your property structure in the CMS Dashboard
Before using a Dynamic filter, design your property structure — including reference relationships — in the CMS Dashboard.
Create article items in an Article type CMS model.
Create CMS models for article classification, such as categories or tags.
In the Article type CMS model, set up a property (reference property) that references the CMS model you created in step 2. Choose either single select or multi select.
The reference property you set up here determines how list items are dynamically filtered on the dynamic page.
In the image below, as an example, an Article type model called [Workshops] has a property that references a Category type model called [Category].
Preparation 2: Create a dynamic page to display Article model items
Create a dynamic page to display items from your Article model.
Step 1: Add a CMS List to your dynamic page
Open the Design Editor.
Add a dynamic page where you want to display the article list or category-based list, or open an existing dynamic page.
Select the [Connect] icon
from the left navigation to open the Connect Panel.
Adjust the appearance and layout as needed.
If needed, refer to the Box design settings article collection.
Step 2: Set up a Dynamic filter on the CMS List
Select the CMS List you placed on the page. Make sure you select the entire CMS List, not just an individual list item.
In the right panel, select the [Data] tab. If the panel is closed, open the right panel first.
Under [Filter], follow these steps to configure the filter:
Click the [+] next to [Filter] to add a filter.
In the [Filter] input field, select the reference property you set up for article classification in Preparation 1 from the dropdown list.
In the image below, as an example, the reference property for the Category model [Category] is selected.
In the [Filter condition] input field, select the condition that shows [Dynamic].
If you see [URL query configured], click the [Set value individually] link button that appears next to it to select a condition.
If [Dynamic] does not appear in the dropdown list, review the "Requirements for setting up a Dynamic Filter" section on this page and make sure your CMS models and reference properties meet the conditions.
Step 3: Verify the behavior in preview or on the live site
Check whether the filter conditions are working as expected in the editor or in Live Preview.
Update your site from the publish panel. Changes won't appear on your live site until you complete this step.
Important notes about filter settings
You can add up to 5 filters.
When multiple filter conditions are set, they are all applied as AND conditions. OR conditions are not supported.