Core Concepts

Query Name - The Connection Key

All elements must share the same Query Name to work together.

The Query Name is how elements communicate with each other. Think of it as a channel - all elements tuned to the same channel will work together.

Example:
- Main Query: query_name = "my-products"
- Facet 1: query_name = "my-products"
- Facet 2: query_name = "my-products"
- Pagination: query_name = "my-products"

✅ All elements share "my-products" = They work together
❌ Different query names = Elements won't connect

Apply On: Input vs Submit

Most filter elements have an "Apply on" setting:

  • Input (Immediate): Filter triggers instantly when user makes a selection

  • Submit (Button): Filter waits until user clicks the Submit/Apply button

Use "Submit" mode when you have multiple filters and want users to select all options before filtering.

Last updated