> For the complete documentation index, see [llms.txt](https://themedocs.zenit.design/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://themedocs.zenit.design/update-guides/shopware-6.5.0.0.md).

# Shopware 6.5.0.0

## Nach dem Update

### Kontrast Schwellenwert anpassen

Es gibt im Theme bestimmte Bereiche, deren Vordergrundfarbe anhand der Hintergrundfarbe ermittelt wird. Das ist beispielsweise bei den Primärbuttons der Fall. Das Kontrastverhältnis bestimmt, wann die Helligkeit der Farbe von "dunkel" zu "hell" wechselt.

Beispiel:

<div><figure><img src="/files/SsG6maW1BDRmw9MR4Ixl" alt=""><figcaption><p>Schwellenwert 4.5</p></figcaption></figure> <figure><img src="/files/kZ8q3dMwXoQittbAyYzw" alt=""><figcaption><p>Schwellenwert 2</p></figcaption></figure></div>

In Shopware 6.5 wurde die Berechnungsgrundlage auf die Web Content Accessibility Guidelines (WCAG) angepasst. Durch diesen neuen Standard kann es sein, dass die Vordergrundfarbe auf den Buttons nun anders dargestellt wird.

Du kannst den Schwellenwert unter Typografie & Farben > Theme-Farben > Grundeinstellungen in der neuen Konfiguration **Kontrast Schwellenwert (1)** anpassen.

<figure><img src="/files/H7LK72OACb8uzuES3mdS" alt=""><figcaption></figcaption></figure>

### Pfade lokaler Schriften aktualisieren

Solltest Du individuelle Schriften durch eine kleine Programmierung in Deinen Shop mit Hilfe eines **Child-Themes** implementiert haben, solltest Du nun die Implementierung erneut prüfen.

{% hint style="success" %}
CSS Implementierungen von Schriften ohne Child-Theme über den public/fonts Ordner sind hiervon nicht betroffen.
{% endhint %}

Mit dem Update auf Shopware 6.5 hat Shopware die Theme-Assets überarbeitet. Assets wie zum Beispiel Schriften können nicht mehr wie in Shopware 6.4 über den relativen Pfad **`../assets/font/`** angesprochen werden. In SCSS kann nun mit einer Variable **`#{$app-css-relative-asset-path}`** auf die Pfade der Schriften zugegriffen werden.&#x20;

{% hint style="info" %}
Mehr dazu findest Du im Update Guide von Shopware:\
<https://github.com/shopware/shopware/blob/v6.5.6.0/UPGRADE-6.5.md#storefront-theme-asset-refactoring>
{% endhint %}

Passe daher Deine Pfade wie in diesem Beispiel an:

<pre class="language-scss"><code class="lang-scss">// Old
@font-face {
  font-display: swap; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
  font-family: 'Raleway';
  font-style: normal;
  font-weight: 400;
  src: url('<a data-footnote-ref href="#user-content-fn-1">../assets/font/</a>raleway-v29-latin-regular.woff2') format('woff2'); /* Chrome 36+, Opera 23+, Firefox 39+, Safari 12+, iOS 10+ */
}
</code></pre>

<pre class="language-scss"><code class="lang-scss">// New
/* raleway-regular - latin */
@font-face {
  font-display: swap; /* Check https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display for other options. */
  font-family: 'Raleway';
  font-style: normal;
  font-weight: 400;
  src: url('<a data-footnote-ref href="#user-content-fn-2">#{$app-css-relative-asset-path}/font/</a>raleway-v29-latin-regular.woff2') format('woff2'); /* Chrome 36+, Opera 23+, Firefox 39+, Safari 12+, iOS 10+ */
}
</code></pre>

{% hint style="info" %}
Mehr zum Thema "Linking to assets" findest Du in der Shopware Doku:\
<https://developer.shopware.com/docs/guides/plugins/themes/add-assets-to-theme.html#linking-to-assets>
{% endhint %}

## Warum wird die neue Theme Version 3.0.0 nicht angezeigt?

Wird in der Administration kein Update angezeigt, obwohl im Store bereits eine neue Version aufgeführt wird, ist Deine aktuelle Shopware Version noch nicht mit dem neuen Update kompatibel. Das betrifft aktuell alle Shopware Shops mit einer Version 6.4.x.x und kleiner.

Unsere Themes sind grundsätzlich mit der aktuellsten Shopware Version kompatibel. Dabei bemühen wir uns, neue Version immer auch für ältere Shopware Versionen bereitzustellen. Mit den Änderungen von Shopware in Version 6.5.x.x war dies leider auf Grund von strukturellen Änderungen (von Shopware "Breaking Changes" genannt) der Shopsoftware so nicht möglich.

### Ursache

> Theme Versionen **2**.x.x sind kompatibel mit Shopware 6.**4**.x.x aber nicht 6.**5**.x.x\
> Theme Versionen **3**.x.x sind kompatibel mit Shopware 6.**5**.x.x aber nicht 6.**4**.x.x

Daher wird vor dem Update auf Version 6.5.x.x auch noch kein Update des Themes auf Version 3.x.x angezeigt und umgekehrt erscheint die aktuell installierte Version des Themes 2.x.x als nicht kompatibel.

### Lösungsvorschlag

Aktualisiere Shopware auf die aktuelle Shopware 6.5.x.x auf gewohntem Weg. Nach dem Update steht Dir die neue Theme Version über die Administration zum Download und Update wie gewohnt zur Verfügung.

{% hint style="success" %}
Shopware schlägt vor, inkompatible Apps / Themes während des Update-Vorgangs zu deaktivieren. In unseren eigenen Demos haben wir das mit unseren Themes **nicht** gemacht. Aus Sicht unserer Themes ist das nicht notwendig, jedoch kann dies bei anderen Erweiterungen durchaus notwendig sein.

\
Wenn Du sicher gehen willst, deaktiviere das Theme vorübergehend und aktualisiere es nach erfolgtem Update.
{% endhint %}

{% hint style="danger" %}
Eine Sicherung des Shops ist wie bei jedem Update notwendig.
{% endhint %}

[^1]: Old path

[^2]: New path


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://themedocs.zenit.design/update-guides/shopware-6.5.0.0.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
