> For the complete documentation index, see [llms.txt](https://docs-sw5.zenit.design/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-sw5.zenit.design/plugins/countdown-banner/bildgroesse-und-bildformat.md).

# Bildgröße und Bildformat

In den Einstellungen des Banners kann eine Bilddatei für den Hintergrund hochgeladen werden. Die angezeigte Hintergrundgröße und Positionierung können dabei über die Konfigurationen "Hintergrund Größe" und Hintergrund Position" eingestellt werden. Wie auch bei den Einkaufswelten von Shopware gibt es kein Allgemein-Rezept für die Bildgröße des Banners, da hier viele Faktoren wie etwa das Format des Banners, die Größeneinstellung und Positionierung des Bildes eine Rolle spielen.

**Hintergrund Größe** - diese Eigenschaft definiert die Abmessungen eines Hintergrundbildes.

**auto** - Das *auto* Schlüsselwort skaliert das Hintergrundbild so in die entsprechende Richtung, dass das ursprüngliche Seitenverhältnis beibehalten wird.

**cover** - Das *cover* Schlüsselwort behält das Seitenverhältnis des Hintergrundbildes bei und skaliert es so, dass es so klein wie möglich ist, aber den Hintergrund-Positionierungsbereichs vollständig abdeckt.\
**contain** - Das *contain* Schlüsselwort behält das Seitenverhältnis des Hintergrundbildes bei und skaliert es so, dass es so groß wie möglich ist, aber vollständig im Hintergrund-Positionierungsbereichs enthalten ist.

**Hintergrund Position** - diese Eigenschaft bestimmt die Position des Hintergrundbildes im Bereich des Banners.

In den meisten Fällen sollen die Hintergrundbilder füllend dargestellt, sodass diese den kompletten Banner Bereich ausfüllen. Hier greift die Eigenschaft für die Hintergrund Größe *cover*. Für diesen Fall sind Bildgrößen ratsam, welche prinzipiell die komplette Browserbreite füllen können. Eine gängige Größe ergibt sich aus der Auflösung vieler heutiger Monitore, sodass die Breite der HD-Aulösung als Richtwert verwendet werden kann. 

{% hint style="warning" %}
**1920** Pixel in der Breite ist hier eine gute Basis.
{% endhint %}

Die Höhe wiederum ist abhängig vom Motiv, sollte jedoch nicht niedriger als die Höhe des Banners gewählt werden. Insbesondere die kleinen mobilen Geräte wie Smartphones stellen den Banner nicht mehr horizontal, sondern eher quadratisch oder sogar hochkant dar, sodass das Bildformat diese Anforderung erfüllen sollte.

![](/files/-MNz9Y3dLXt3j-Bu9krQ)


---

# 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://docs-sw5.zenit.design/plugins/countdown-banner/bildgroesse-und-bildformat.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.