> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/filter.md).

# Filter

Filter anlegen und bearbeiten, als Liste oder Schieberegler, mit Position, NLP-Keywords und allen Optionen.

Mit Filtern bestimmen Sie, welche Möglichkeiten zum Eingrenzen Ihre Kunden in der Suche sehen, zum Beispiel nach Kategorie, Preis, Größe, Farbe oder Marke. Die Filter erscheinen neben oder über den Suchergebnissen und helfen, große Treffermengen schnell zu verkleinern. Sie pflegen sie im Plugin-Dashboard unter **Filter**.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-b2ae11f8c21050ca6802e260bd3184129571db9d%2Fsuche-intelligent-und-ki-optimiert-filter.png?alt=media" alt="Bereich Filter mit fünf Filtern je Datenquelle: Name, Darstellung, Position, Bearbeiten und Löschen"><figcaption></figcaption></figure>

Wählen Sie oben bei „Produkt-Feed wählen“ die Datenquelle. Die Übersicht „Konfigurierte Filter je Datenquelle“ zeigt, wie viele Filter jede Quelle hat. In der Liste sehen Sie je Filter den Namen, den Typ (Liste oder Schieberegler) und die Position, dazu die Knöpfe „Bearbeiten“ und „Löschen“. Filter, die nur im Shopping-Assistenten benutzt werden, tragen das Label „nur Assistent“. Der Knopf „Hinzufügen“ erscheint, sobald eine Quelle gewählt ist.

{% hint style="warning" %}
Ob Ihre Kunden die Filter im Such-Fenster überhaupt sehen, steuert der Schalter „Aktiviert die Filter in der Suche“ in der Plugin-Konfiguration. Er ist standardmäßig aus.
{% endhint %}

## Voraussetzungen

Ein Filter baut auf einem Datenattribut auf. Als Filter stehen nur Felder zur Verfügung, bei denen beides zutrifft:

1. Das Feld ist unter **Datenfelder bearbeiten** aktiviert.
2. Das Datenattribut ist im Bereich **Datenattribute** freigeschaltet (Spalte „Aktiv“).

Fehlt ein Attribut in der Auswahl, aktivieren Sie es an diesen Stellen und lesen die Produktdaten unter **Quellen** mit „Produktdaten neu einlesen“ neu ein. Ändern Sie den Typ eines Datenattributs, wirkt das ebenfalls erst nach dem nächsten Einlesen.

Ein Schieberegler ist für Zahlenfelder gedacht. Wirkt ein Bereichsfilter wie „ab 20“ nicht, prüfen Sie in den Datenattributen, ob das Feld den Typ „Zahl“ hat, und achten Sie dort auf die Markierung „Typ prüfen“.

## Welche Zahlen die Filter zeigen

Die Zähler hinter den Filteroptionen zählen Varianten, nicht Produkte. Fassen Sie Varianten in der Suche zu einem Treffer zusammen, kann die Zahl neben einer Option deshalb größer sein als die Zahl der Treffer in der Liste.

## Filter anlegen oder bearbeiten

1. Wählen Sie die Datenquelle bei „Produkt-Feed wählen“.
2. Klicken Sie auf „Hinzufügen“, oder bei einem bestehenden Filter auf „Bearbeiten“. Es öffnet sich derselbe Dialog.
3. Füllen Sie die Felder aus (Tabelle unten).
4. Klicken Sie auf „Speichern“. Der Knopf wird aktiv, sobald Quelle, Attribut, Name und Typ gefüllt sind.

Beim Löschen fragt der Browser vorher nach.

### Felder im Dialog

| Feld                    | Wirkung                                                                                                                                                                                                                      | Standard                         |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| „Attribute“ (Pflicht)   | Das Produktfeld, auf dem der Filter beruht, also der Rohwert aus Ihren Produktdaten. Beispiel: `g:brand` steht für den Hersteller, `g:color` für die Farbe. Es stehen nur aktivierte und freigeschaltete Attribute zur Wahl. | keiner                           |
| „Name“ (Pflicht)        | Der Titel, den Ihre Kunden im Shop sehen, zum Beispiel „Marke“, „Farbe“, „Größe“ oder „Preis“.                                                                                                                               | leer                             |
| „Typ“ (Pflicht)         | „Liste“ für mehrere Werte wie Marken oder Farben, „Slider“ (Schieberegler) für Bereiche wie Preis oder Größe.                                                                                                                | „Liste“                          |
| „Position“ (Pflicht)    | Zahl. Kleinere Werte stehen weiter oben in der Filterliste.                                                                                                                                                                  | 0                                |
| „Standardzustand“       | „Standard (globale Einstellung)“, „Immer geöffnet“ oder „Immer geschlossen“. Bestimmt, ob die Filtergruppe beim Laden der Ergebnisse aufgeklappt ist.                                                                        | „Standard (globale Einstellung)“ |
| „NLP-Keywords“          | Begriffe, mit denen Kunden in natürlicher Sprache nach diesem Filter fragen (siehe unten).                                                                                                                                   | leer                             |
| „Aktiv“                 | Schaltet den Filter ein oder aus.                                                                                                                                                                                            | an                               |
| „In der Suche anzeigen“ | Aus: Der Filter wird nur im Shopping-Assistenten benutzt und erscheint nicht in Suche und Listing.                                                                                                                           | an                               |

Gruppen mit gewählten Werten sind im Shop immer aufgeklappt, egal welcher Standardzustand gilt.

## Typ „Liste“

Die Liste zeigt Auswahl-Knöpfe mit Beschriftung und Trefferzahl. Kunden können mehrere Werte je Gruppe wählen. Es erscheinen nur Optionen, die zur aktuellen Suche vorhanden sind. Wie viele Optionen sichtbar sind, bevor „Mehr anzeigen“ erscheint, stellen Sie in der Plugin-Konfiguration unter „Sichtbare Optionen je Filter“ ein (1 bis 50, Standard 5).

## Typ „Slider“ (Schieberegler)

Für Zahlenwerte wie Preis oder Gewicht stellen Sie einen Filter als Schieberegler dar. Sobald Sie den Typ „Slider“ wählen, erscheint im Dialog der Abschnitt „Erweiterte Darstellung (Schieberegler)“.

| Feld                  | Wirkung                                                                                                                                                                   | Standard                   |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
| „Schrittweite“        | Abstand zwischen zwei Reglerstellungen. Leer lassen: Die Schrittweite wird aus dem Wertebereich berechnet.                                                                | „auto“                     |
| „Nachkommastellen“    | Anzahl der angezeigten Nachkommastellen, 0 bis 4.                                                                                                                         | 0                          |
| „Rundung der Grenzen“ | „Standard“, „Auf glatte Werte“, „Auf die Schrittweite“ oder „Gar nicht“. Legt fest, wie die Enden des Reglers gerundet werden.                                            | „Standard“                 |
| „Eingabemodus“        | „Standard (Schieberegler)“, „Nur Schieberegler“, „Nur Zahlenfelder“, „Schieberegler und Zahlenfelder“ oder „Preisstufen“ (Auswahl-Knöpfe wie „bis 20 €“ mit Trefferzahl). | „Standard (Schieberegler)“ |
| „Präfix“              | Text vor dem Wert.                                                                                                                                                        | leer                       |
| „Suffix“              | Text nach dem Wert, zum Beispiel `€` mit führendem Leerzeichen.                                                                                                           | leer                       |
| „Einheit“             | Wird immer angehängt, unabhängig von Präfix und Suffix, zum Beispiel „kg“.                                                                                                | leer                       |
| „Währung“             | Ist sie gesetzt, überschreibt sie Präfix und Suffix, zum Beispiel „EUR“.                                                                                                  | leer                       |
| „Untergrenze“         | Kleinster Wert des Reglers.                                                                                                                                               | leer                       |
| „Obergrenze“          | Größter Wert des Reglers, unabhängig von den tatsächlichen Werten. Gilt auch bei der Suche selbst, nicht nur in der Anzeige.                                              | leer                       |
| „Bei nur einem Wert“  | „Ausblenden (Standard)“ oder „Trotzdem anzeigen“.                                                                                                                         | Ausblenden                 |
| „Histogramm“          | Zeigt über dem Regler die Verteilung der Treffer als Balken. Braucht Unter- und Obergrenze, sonst bleibt es aus.                                                          | aus                        |
| „Balken“              | Anzahl der Balken, 4 bis 100. Nur bearbeitbar, wenn das Histogramm an ist.                                                                                                | 20                         |
| „Balkenbreite“        | Breite eines Balkens. Leer lassen: Die Breite wird aus Unter- und Obergrenze berechnet.                                                                                   | „auto“                     |

Es werden nur die Werte gespeichert, die Sie gesetzt haben. Im Shop wird erst nach dem Loslassen des Reglers neu gesucht, nicht bei jedem Zwischenschritt.

{% hint style="info" %}
Bei automatischer Schrittweite richtet sich der Abstand nach der Spanne der Werte: bis 5 gilt 0,1, bis 100 gilt 0,5, darüber 1.
{% endhint %}

Für Werte, die keine Zahlen sind (zum Beispiel Größen wie S, M, L), zeigt der Shop einen Stufen-Regler über die geordneten Werte.

## NLP-Keywords

NLP („Natural Language Processing“) bedeutet, dass die Suche ganze Sätze versteht, zum Beispiel „nur rote Schuhe“ oder „zeige mir Markenprodukte“. Mit den NLP-Keywords hinterlegen Sie die Wörter, mit denen Kunden auf einen Filter zielen.

Beispiele:

* **Markenfilter:** Sie tragen „Marke“, „Hersteller“, „Brand“ ein. Die Suche erkennt dann Formulierungen mit diesen Wörtern und wendet den Filter an.
* **Filter mit Einheit:** Haben Sie an einem Bereichsfilter das Stichwort „kg“ hinterlegt, versteht die Suche „unter 5 kg“, „ab 2 kg“, „zwischen 2 und 5 kg“ und „5 kg“ als Bereiche.
* **Preise im Text:** Angaben wie „unter 50 €“, „bis 100 Euro“, „ab 20 €“ oder „zwischen 20 und 40 Euro“ setzen einen Preisfilter und werden aus dem Suchtext entfernt. Das klappt aber nur, wenn für den Preis ein Schieberegler eingerichtet ist. Sonst bleibt der Text in der Suche und es wird nicht gefiltert.

Passt ein Wort aus der Eingabe zu einem Filterwert, kann die Suche es selbst als Filter setzen, zum Beispiel bei „nur rote Schuhe“. Dabei helfen die NLP-Keywords des Filters (siehe oben). Einen eigenen Schalter dafür gibt es nicht.

## Filter nur für den Shopping-Assistenten

Schalten Sie „In der Suche anzeigen“ aus, taucht der Filter in Suche und Listing nicht mehr auf. Der Shopping-Assistent (Beta) nutzt ihn weiter, in der Liste trägt er das Label „nur Assistent“. So halten Sie Filter bereit, die für ein Beratungsgespräch sinnvoll sind, aber Ihre Filterleiste unübersichtlich machen würden.

## Wann Änderungen im Shop sichtbar sind

Die Filter-Einstellungen werden zwischengespeichert. Änderungen sind deshalb nach bis zu 5 Minuten im Shop sichtbar. Neue Datenattribute als Basis brauchen zusätzlich ein Neu-Einlesen der Produktdaten.

## Tipps

* Legen Sie nur Filter an, die Ihre Kunden wirklich nutzen. Eine kurze Filterleiste ist übersichtlicher.
* Vergeben Sie die Positionen in Zehnerschritten (10, 20, 30). So fügen Sie später einen Filter dazwischen ein, ohne alles umzunummerieren.
* Für den Preis eignet sich ein Schieberegler mit Währung, Unter- und Obergrenze und Histogramm.
* Prüfen Sie nach dem Speichern im Shop, wie der Filter aussieht. Für Mobilgeräte stellen Sie in der Plugin-Konfiguration ein, ob die Filter sofort sichtbar oder hinter einem Knopf eingeklappt sind.

## Weiterlesen

{% content-ref url="/pages/zsJr3fdaXeR7dV1yGTh9" %}
[Datenattribute](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/datenattribute.md)
{% endcontent-ref %}

{% content-ref url="/pages/gnVUxo3jg0HO6NiKigX0" %}
[Synonyme](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/synonyme.md)
{% endcontent-ref %}

{% content-ref url="/pages/Y10tltOcYws4krNqaMS1" %}
[Suchergebnisseite](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suchergebnisseite.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/filter.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
