Skip to main content
The WEBSALE | search module supports, in addition to the classic filter_eq[] notation, extended comparison operators for dynamic filtering via the URL. This function is particularly suitable for direct-linking to filtered lists, e.g. in teasers, landing pages, or marketing campaigns.

General syntax of the URL parameters

Filters can be passed directly to the search module via the URL. Structure of the filter parameters
Example of setting a color filter
Parameter in a complete URL
Extending the URL with a price filter Shows all products with a price between 10 € and 20 €.

Supported filter operators

To visually indicate in the chip that it is a negative filter, the neq-label attribute can be used in <ws-filter-chip>. You can find more about this in the documentation for the ws-filter-chip component.

Automatic filter initialization on page load

When a page is loaded, filters are automatically set from the URL parameters and the search is executed automatically. This means that deep links to filtered search results work without additional template JavaScript. Example
When this URL is called, the following happens automatically:
  • The filter brand is set to the value nike, the filter color to red.
  • The URL path (/kategorie/unterkategorie) is used as a category filter.
  • The filter UI is automatically preselected: for eq filters, the corresponding options are checked (checkbox, image, and label filters, including static options); range filters set sliders and input fields to the passed values.
  • The search is executed automatically with the set filters.
The automatic filter initialization is included natively in the WebComponents from ws-search-component-1.9.1.js. In older versions, this behavior had to be implemented via JavaScript in the template (see Filter & sort on categories).