WordPress-Plugin-Banner: die richtige Größe

Zwei Dateien: banner-772x250 und banner-1544x500, als PNG oder JPG. Jede muss genau die Größe aus ihrem Namen haben und darf höchstens 4 MB groß sein. Sie gehören in den Ordner assets ganz oben in deinem SVN-Repository, neben trunk, nicht hinein.

Am Plugin Handbook geprüft am 22. November 2026. Quelle

Standard
banner-772x250.png
Hohe Auflösung
banner-1544x500.png
Formate
PNG oder JPG
Max. Dateigröße
4 MB

Wohin die Dateien gehören

Banner, Icons und Screenshots liegen in einem Ordner namens assets ganz oben in deinem SVN-Repository, neben trunk und tags. Sie gelten für jede Version des Plugins. Du kannst ein Banner also austauschen, ohne ein neues Release zu veröffentlichen.

your-plugin/
├── assets/            ← banners, icons, screenshots
│   ├── banner-772x250.png
│   ├── banner-1544x500.png
│   ├── icon-128x128.png
│   ├── icon-256x256.png
│   └── screenshot-1.png
├── tags/
│   └── 1.2.0/
└── trunk/             ← plugin code and readme.txt

Ein häufiger Fehler ist trunk/assets oder ein Ordner in einem Tag. Dort sucht WordPress.org nicht, und die Bilder landen stattdessen im Download jedes Nutzers.

Warum du beide Größen brauchst

Die Datei mit 1544 × 500 wird nur auf hochauflösenden Bildschirmen gezeigt, und nur, wenn es auch eine Datei mit 772 × 250 gibt. Allein wird sie ignoriert. Am einfachsten gestaltest du in 1544 × 500 und exportierst eine Kopie in halber Größe.

DateiGrößeWofür
banner-772x250.png772 × 250 pxAlle Bildschirme. Pflicht.
banner-1544x500.png1544 × 500 pxHochauflösende Bildschirme, zusätzlich

JPG geht unter denselben Namen (banner-772x250.jpg). PNG eignet sich für Flächen und Schrift, JPG für Fotos.

Genaue Größe, genauer Name

Die Maße müssen zu den Zahlen im Dateinamen passen, andere Größen gibt es nicht. Eine Datei namens banner-1544x500.png, die in Wahrheit 1500 × 486 groß ist, wird nicht angezeigt. Schreib die Namen klein.

Auf dem Handy lesbar bleiben

Das Banner schrumpft mit der Seite, auf dem Handy also auf einen Bruchteil von 772 Pixeln. Schrift, die am Monitor gut aussieht, ist dort nicht mehr lesbar. Nimm eine Zeile in großer Schrift oder gar keine, den Rest erledigt der Plugin-Name unter dem Banner.

Für Sprachen, die von rechts nach links laufen, kannst du banner-772x250-rtl.png ergänzen. Sprachversionen bekommen das Locale als Endung, zum Beispiel banner-772x250-de_DE.png. Leg sie nur an, wenn sie sich wirklich unterscheiden: Eine Kopie des englischen Banners unter deutschem Namen verdeckt nur das Original.

Das neue Banner erscheint nicht

Die Bilder werden über ein CDN mit starkem Cache ausgeliefert. Meist ist eine Änderung nach ein paar Minuten zu sehen, rund um ein großes WordPress-Release kann es bis zu sechs Stunden dauern.

Wird das Bild heruntergeladen statt angezeigt, hat SVN es mit dem falschen Dateityp gespeichert. Setz ihn und committe erneut:

svn propset svn:mime-type image/png assets/*.png
svn propset svn:mime-type image/jpeg assets/*.jpg

Wie oft fehlt es?

Von den 100 zuletzt veröffentlichten Plugins, die wir uns im Oktober 2026 angesehen haben, hatten 27 kein Banner. Ihre Seite beginnt ohne Titelbild, und das ist das Erste, was ein Besucher sieht.