> 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/design-anpassen.md).

# Design anpassen

Die Suche an Ihr Shop-Design anpassen: eigene Farben, eigenes Stylesheet, Ecken, Platzhalter-Text, Ersatzbild und Hinweise für Agenturen.

Die Suche übernimmt von selbst den Akzent und die Textfarbe Ihres Themes. Wenn Sie mehr wollen, haben Sie drei Stufen: Farben über Variablen setzen, ein eigenes Stylesheet ergänzen oder das Standard-Design ganz ersetzen. Diese Seite zeigt alle Möglichkeiten und richtet sich auch an Agenturen.

Alle Einstellungen liegen in der Plugin-Konfiguration auf der Karte „Sucheinstellungen“ und gelten je Verkaufskanal. Sie brauchen dafür weder einen Theme-Neubau noch eine Kompilierung.

## Eigene Farben

Im Feld „Eigene Suchfarben (CSS Variablen)“ legen Sie die Farben fest. Das Format ist eine Zeile je Wert:

```
--cogi-search-accent-color: #c8102e;
--cogi-search-modal-bg: #fff8f0;
```

Jede Zeile endet mit einem Strichpunkt. Innerhalb eines Werts darf kein Strichpunkt stehen. Ihre Werte gewinnen gegen die Standardwerte des Plugins und gelten für das Fenster und den abgedunkelten Hintergrund. Sie wirken auch im Aktivierungsmodus „Aktivierung über externen Trigger“.

Das Feld ist nach der Installation vorbelegt. Sie sehen dort alle Variablen mit ihrem Ausgangswert und ändern nur, was Sie brauchen.

| Variable                            | Vorbelegung                              | Wirkung                                       |
| ----------------------------------- | ---------------------------------------- | --------------------------------------------- |
| `--cogi-search-text-color`          | Textfarbe Ihres Themes, sonst `#1f2937`  | Text                                          |
| `--cogi-search-muted`               | `#64748b`                                | Nebentexte                                    |
| `--cogi-search-accent-color`        | Primärfarbe Ihres Shops, sonst `#0ea5e9` | Akzent: aktive Filter, Links, Auswahl, Regler |
| `--cogi-search-modal-bg`            | `rgba(255, 255, 255, 0.98)`              | Hintergrund des Such-Fensters                 |
| `--cogi-search-card-bg`             | `#ffffff`                                | Hintergrund der Produktkarten                 |
| `--cogi-search-image-bg`            | `#ffffff`                                | Hintergrund hinter dem Produktbild            |
| `--cogi-search-form-bg`             | `transparent`                            | Hintergrund des Eingabebereichs               |
| `--cogi-search-input-bg`            | `#f8fafc`                                | Eingabefeld                                   |
| `--cogi-search-button-bg`           | `#f1f5f9`                                | Knöpfe                                        |
| `--cogi-search-button-color`        | `#334155`                                | Text auf Knöpfen                              |
| `--cogi-search-border-color`        | `#e2e8f0`                                | Rahmen                                        |
| `--cogi-search-input-border`        | `transparent`                            | Rahmen des Eingabefelds                       |
| `--cogi-search-scrollbar`           | `#cbd5e1`                                | Scrollbalken                                  |
| `--cogi-search-suggest-hover`       | `#f1f5f9`                                | Vorschlag beim Überfahren                     |
| `--cogi-search-suggest-active`      | `#e2e8f0`                                | Vorschlag, wenn markiert                      |
| `--cogi-search-filter-hover`        | `#f1f5f9`                                | Filteroption beim Überfahren                  |
| `--cogi-search-filter-active`       | `#e2e8f0`                                | aktive Filteroption                           |
| `--cogi-search-filter-count-active` | `rgba(14, 165, 233, 0.1)`                | Zahl an der aktiven Filteroption              |
| `--cogi-search-focus-ring`          | `rgba(14, 165, 233, 0.25)`               | Fokusrahmen                                   |
| `--cogi-search-button-shadow`       | `transparent`                            | Schatten der Knöpfe                           |
| `--cogi-search-placeholder-color`   | `#94a3b8`                                | Platzhaltertext im Feld                       |
| `--cogi-search-chrome-bg`           | `#ffffff`                                | Hintergrund von Kopf und Rahmen               |
| `--cogi-search-overlay-bg`          | `rgba(15, 23, 42, 0.65)`                 | abgedunkelter Hintergrund hinter dem Fenster  |
| `--cogi-search-surface`             | `#f8f9fa`                                | Flächen                                       |
| `--cogi-search-filter-panel-bg`     | `#f8fafc`                                | Filter-Seitenleiste                           |
| `--cogi-search-filter-chip-bg`      | `#ffffff`                                | Auswahl-Knöpfe der Filter                     |

Zusätzlich können Sie diese Variablen setzen, auch wenn sie nicht vorbelegt sind:

| Variable                    | Standard                                       | Wirkung                                 |
| --------------------------- | ---------------------------------------------- | --------------------------------------- |
| `--cogi-search-radius`      | vom Plugin gesetzt (siehe „Abgerundete Ecken“) | Rundung der Ecken                       |
| `--cogi-search-width`       | `clamp(960px, 90vw, 1440px)`                   | Breite des Fensters                     |
| `--cogi-search-accent-soft` | `rgba(17, 24, 39, 0.06)`                       | dezenter Hintergrund in der Akzentfarbe |
| `--cogi-filter-max-height`  | `60vh`                                         | Höhe der Filterleiste                   |

{% hint style="warning" %}
Leeren Sie das Feld, gelten die Standardfarben des Plugins (ein nahezu schwarzer Akzent `#111827` im hellen Schema) und nicht mehr der vorbelegte Akzent Ihres Shops. Löschen Sie deshalb lieber einzelne Zeilen, die Sie nicht ändern, nicht das ganze Feld.
{% endhint %}

**Beispiel:** Ein Shop mit roter Hausfarbe und warmem Fensterhintergrund setzt

```
--cogi-search-accent-color: #c8102e;
--cogi-search-modal-bg: #fff8f0;
--cogi-search-filter-count-active: rgba(200, 16, 46, 0.1);
--cogi-search-focus-ring: rgba(200, 16, 46, 0.25);
```

Die letzten beiden Zeilen färben die Zahl an der aktiven Filteroption und den Fokusrahmen passend zur Akzentfarbe, denn diese Werte sind sonst blau vorbelegt.

## Abgerundete Ecken

„Abgerundete Ecken verwenden“ ist standardmäßig an: Die Ecken haben eine Rundung von 0,625 rem. Ausgeschaltet sind sie eckig. Die Einstellung setzt die Variable `--cogi-search-radius`. Tragen Sie sie selbst in „Eigene Suchfarben“ ein, gewinnt Ihr Wert. Die Karten im 2er-Raster auf dem Handy sind 60 Prozent so rund wie der Wert.

## Eigenes Stylesheet

Im Code-Editor „Eigenes Stylesheet für die Suche“ ergänzen Sie eigenes CSS. Es wird als Stilblock in die Seite geladen, nachdem die Seite aufgebaut ist, und gilt je Verkaufskanal. Es wirkt nur, wenn die Suche aktiv ist und das Layout nicht „Natives Shopware-Design“ ist.

Das ist der richtige Weg für Dinge, die Variablen nicht abdecken: andere Schriftgrößen, Abstände, ein verändertes Kartenformat oder ein Aussehen des Suchfelds im Kopf Ihres Themes.

## Basis-Styling ersetzen

„Basis-Styling durch Custom CSS ersetzen“ ist standardmäßig aus. Schalten Sie es ein, entfällt das Standard-Design der Suche ganz. Das gilt nur, wenn im Stylesheet-Feld etwas steht.

* Ihr CSS muss dann alle Regeln für Fenster, Karten, Filter, Regler und so weiter selbst liefern.
* **Ausgenommen** sind absichtlich die Regeln für „Filter auf Mobilgeräten“ und für die mobilen Designs (Fenster von unten, Leisten, fester Knopf). Sie bleiben aktiv, damit sie mit eigenem CSS nicht kaputtgehen. Siehe [Suche auf dem Handy](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suche-auf-dem-handy.md).

Nutzen Sie diese Option nur, wenn Sie die Suche vollständig selbst gestalten wollen. Für fast alle Fälle reichen Farben und ein ergänzendes Stylesheet.

## Platzhalter im Suchfeld

Zwei Felder steuern den Text im leeren Suchfeld:

| Einstellung                    | Wirkung                                                                                                                                                                             | Standard                          |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |
| „Platzhalter für das Suchfeld“ | Ein Text für alle Sprachen.                                                                                                                                                         | „Enter search term...“ (englisch) |
| „Platzhalter je Sprache“       | Eine Zeile je Sprache im Format `de-DE=Wonach suchen Sie?`. Ein Kürzel wie `de` gilt für alle deutschen Sprachen. Zeilen mit `#` am Anfang werden ignoriert, höchstens 200 Zeichen. | leer                              |

Die Reihenfolge: zuerst die genaue Sprache, dann das Kürzel, dann das Feld „Platzhalter für das Suchfeld“. Ist auch dieses leer, nimmt das Plugin den mitgelieferten Text „Suchbegriff eingeben...“.

{% hint style="warning" %}
Der Standardwert von „Platzhalter für das Suchfeld“ ist Englisch. Tragen Sie für deutsche Shops deshalb einen deutschen Text ein oder nutzen Sie „Platzhalter je Sprache“.
{% endhint %}

{% hint style="info" %}
Der Platzhalter wirkt nur in dem Suchfeld, das das Plugin selbst erzeugt, also bei „Suchfeld immer sichtbar“ und „Aktivierung über externen Trigger“. Bei „Shopware Standard Suchfeld nutzen“ und „Aktivierung über Such-Button“ bleibt der Platzhalter Ihres Themes.
{% endhint %}

## Texte im Fenster

Alle weiteren Texte im Fenster sind Shopware-Textbausteine, die Sie unter Einstellungen → Shop → Textbausteine überschreiben können. Ihre Schlüssel beginnen mit `cogi-insightsearch.storefront.`. Deutsch und Englisch sind mitgeliefert. Für weitere Sprachen legen Sie einen eigenen Textbaustein-Satz an.

Fest eingebaut und nicht übersetzbar sind: das „ab “ vor Von-Preisen, das „UVP “, die Beschriftungen „von“ und „bis“ an den Reglern, „Suche löschen“ und „Logo“.

## Ersatzbild

Das „Ersatzbild für Produkte ohne Bild“ wählen Sie aus Ihren Shopware-Medien, je Verkaufskanal. Es erscheint im Such-Fenster, bei Ersatzprodukten und im Shopping-Assistenten, wenn ein Produkt kein Bild hat oder das Bild nicht lädt. Lädt ein Bild nicht, wird es einmal gegen das Ersatzbild getauscht. Ohne Auswahl bleibt ein grauer Platzhalter mit Bild-Symbol. Cross-Selling Pro nutzt das Bild ebenfalls, wenn dort keines gepflegt ist. Auf der Shopware-Suchergebnisseite und auf Kategorieseiten gilt es nicht.

## Hinweise für Agenturen

* **Reihenfolge der Mittel:** zuerst Variablen, dann ein ergänzendes Stylesheet, zuletzt „Basis-Styling ersetzen“.
* **Seiten-Zwischenspeicher:** Die Konfiguration steckt im Kopf jeder Seite. Nach Änderungen kann es nötig sein, den Shop-Zwischenspeicher zu leeren, bis überall dasselbe zu sehen ist.
* **Prüfen Sie alle Layouts und das Handy,** bevor Sie live gehen. Karten, Liste, kompaktes Raster und Karussell haben unterschiedliche Strukturen.

## Theme-Konflikte

Stark angepasste Themes können den Aufbau der Kopfzeile oder Klassen verändern. Die Suche überschreibt die Shopware-Vorlagen für die Kopfzeilen-Suche, das Vorschlagsfenster, die Suchergebnisseite und die Produktliste. Überschreibt Ihr Theme dieselben Vorlagen, können sie sich in die Quere kommen.

Wenn die Suche nicht wie erwartet öffnet:

1. Wechseln Sie den Aktivierungsmodus, zum Beispiel auf „Aktivierung über externen Trigger“ oder „Aktivierung über Such-Button“. Siehe [Die Suche im Shop](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suche-im-shop.md).
2. Prüfen Sie, ob ein Cookie-Banner oder Chat-Fenster den Fokus an sich zieht und das Fenster schließt.
3. Prüfen Sie, ob eine Sicherheitsrichtlinie oder ein Werbeblocker die Suche blockiert.
4. Passen Sie das Aussehen mit einem eigenen Stylesheet an, statt das Theme zu verändern.

Weitere Schritte stehen unter [Fehlersuche](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/fehlersuche.md).

## Weiterlesen

{% content-ref url="/pages/OXAoj5NTuVjQy9UJJi7n" %}
[Die Suche im Shop](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suche-im-shop.md)
{% endcontent-ref %}

{% content-ref url="/pages/4BSNACyJnL4PqGnH9VKn" %}
[Suche auf dem Handy](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suche-auf-dem-handy.md)
{% endcontent-ref %}

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

{% content-ref url="/pages/IRaJNiR83at8tpKODJsz" %}
[Fehlersuche](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/fehlersuche.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/design-anpassen.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.
