> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# URL filter parameters and query parameters of the search

> URL filter and query parameters control filter selection, sorting and pagination of search and category pages in a shareable and bookmarkable way.

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**

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
filter_<operator>[<technical column name from the data feed>]=<value>
```

**Example of setting a color filter**

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
filter_eq[farbe]=beige
```

**Parameter in a complete URL**

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.ihr-shop.de/c/name-der-kategorie?filter_eq[farbe]=beige
```

**Extending the URL with a price filter**

Shows all products with a price **between 10 € and 20 €**.

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://www.ihr-shop.de/c/name-der-kategorie?filter_eq[farbe]=beige&filter_gte[price]=10&filter_lte[price]=20
```

## Supported filter operators

| **Parameter**       | **Meaning**                 | **Description**                          |
| ------------------- | --------------------------- | ---------------------------------------- |
| `filter_eq[field]`  | equal (`=`)                 | Exact match                              |
| `filter_neq[field]` | not equal (`≠`)             | Excludes values                          |
| `filter_gte[field]` | greater than or equal (`≥`) | Filters values **greater than or equal** |
| `filter_lte[field]` | less than or equal (`≤`)    | Filters values **less than or equal**    |

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](/en/ws-search/integration-in-die-templates-storefront/webcomponents/ui-komponenten/ws-filter-chip).

## 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**

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
https://test.shop.websale.net/kategorie/unterkategorie?filter_eq[brand]=nike&filter_eq[color]=red
```

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.

<Info>
  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](/en/ws-search/integration-in-die-templates-storefront/filtern-sortieren-auf-kategorien)).
</Info>