SVG-Dateien hochladen

SVG-Dateien in die Mediathek hochladen und verstehen, wie Easy SVG Support jede Datei bereinigt, welche Wege abgedeckt sind und warum eine Datei abgelehnt wird.

Sind SVG-Uploads eingeschaltet, lädst du eine SVG genauso hoch wie ein Foto. Diese Anleitung zeigt die Schritte, was das Plugin unterwegs mit der Datei macht und was du tust, wenn eine Datei abgelehnt wird.

Bevor du loslegst

Easy SVG Support ist installiert und aktiv. Siehe Installation.
SVG-Uploads in der Mediathek erlauben ist unter Icons → Einstellungen eingeschaltet.
Deine Benutzerrolle darf Dateien hochladen. Administratoren, Redakteure und Autoren dürfen das standardmäßig.

Eine SVG hochladen

Uploader öffnen

Gehe zu Medien → Mediendatei hinzufügen. Du kannst die Datei auch direkt im Block-Editor hinzufügen, zum Beispiel in einem Bild-Block oder als Beitragsbild.

Datei wählen oder ablegen

Klicke auf Dateien auswählen und wähle deine .svg-Datei, oder ziehe sie auf die Upload-Fläche.

Das Plugin bereinigen lassen

Bevor WordPress die Datei speichert, bereinigt Easy SVG Support sie. Das dauert einen Moment und passiert ohne dein Zutun.

Ergebnis prüfen

Die Datei erscheint mit Vorschau in der Mediathek. Du kannst sie jetzt überall nutzen, wo du Bilder nutzt: in Beiträgen, Galerien, als Beitragsbild oder in eigenen Feldern.

Lässt sich die Datei nicht bereinigen, zeigt WordPress stattdessen einen Fehler, und es wird nichts gespeichert. Die Fragen am Ende dieser Seite erklären, warum das passiert und was du tun kannst.

Was die Bereinigung entfernt

Der Sanitizer arbeitet mit einer Allow-Liste: einer Liste von SVG-Tags und -Attributen, die als harmlose Zeichenanweisungen bekannt sind. Was darauf steht, bleibt. Alles andere fliegt raus. Zum Beispiel:

Entfernt	Warum
`<script>`-Elemente	Sie können Code im Browser von jedem ausführen, der die Datei ansieht.
Event-Handler wie `onload` oder `onclick`	Dasselbe Risiko wie Skripte, nur in einem Attribut versteckt.
`javascript:`-Links	Ein Link, der beim Klick Code ausführt.
Verweise auf Dateien, Schriften oder Bilder auf anderen Servern	Sie können Daten deiner Besucher an Dritte weitergeben.

Formen, Pfade, Farben, Verläufe und Text, aus denen die Zeichnung besteht, bleiben erhalten. In der Praxis sieht ein Logo oder Icon aus Illustrator, Figma, Inkscape oder Sketch nach der Bereinigung genauso aus.

Manche Spezialeffekte stehen bewusst nicht auf der Allow-Liste, etwa SVG-Animationen (<animate>) und eingebettetes HTML (<foreignObject>). Eine Datei, die darauf angewiesen ist, sieht nach dem Upload anders aus, weil diese Teile entfernt werden.

Welche Wege abgedeckt sind

Dateien kommen auf mehr Wegen in WordPress als über den Upload-Knopf. Easy SVG Support prüft alle gängigen:

Weg	Was passiert
Mediathek-Uploader und Block-Editor	Vor dem Speichern bereinigt
REST-API (Apps und andere Werkzeuge)	Vor dem Speichern bereinigt
WP-CLI `wp media import`	Vor dem Speichern bereinigt
`media_sideload_image()` (Code, der ein Bild von einer URL lädt)	Vor dem Speichern bereinigt
Importer und anderer Code, der Anhänge anlegt	Direkt nach dem Anlegen noch einmal geprüft. Wieder entfernt, wenn sie sich nicht bereinigen lässt.
XML-RPC (alte Fern-Veröffentlichungswerkzeuge)	Nur angenommen, wenn die Datei schon sauber ist

Die Größengrenze

Jede SVG muss unter Maximale SVG-Größe (MB) in Icons → Einstellungen bleiben. Eine größere Datei wird abgelehnt, nie gekürzt. Die Grenze schützt deinen Server: Eine riesige SVG kann den Sanitizer lange beschäftigen.

Die meisten Icons haben wenige Kilobyte, die meisten Logos bleiben deutlich unter 1 MB. Ist eine Datei größer, steckt oft ein eingebettetes Foto darin. Exportierst du sie ohne das Foto, wird sie meist klein.

Dateien, die schon in der Mediathek lagen

Bereinigt wird, wenn eine Datei ankommt. Dateien, die schon vor der Installation von Easy SVG Support in deiner Mediathek lagen, werden nicht nachträglich geprüft, genauso wenig wie Dateien, die jemand per FTP in den Uploads-Ordner kopiert hat.

Lade solche Dateien neu hoch, um sie zu bereinigen, oder
nutze den SVG-Cleaner in Easy SVG Pro, der sie für dich findet und bereinigt.

Gut zu wissen

Wer hochladen darf. SVG-Uploads brauchen dieselbe Berechtigung wie jede andere Mediendatei. Das Plugin gibt niemandem neue Rechte.
Multisite. Steht svg in deinem Netzwerk nicht unter Erlaubte Dateitypen, kann eine einzelne Website es nicht erlauben. Frag den Netzwerk-Administrator.
Ein anderes Plugin mit älterem Sanitizer. Lädt ein anderes Plugin eine veraltete Kopie der Sanitizer-Bibliothek, sehen Administratoren auf dem Dashboard, in der Plugin-Liste und in der Mediathek eine Warnung, die dieses Plugin nennt. Aktualisiere oder deaktiviere es.

Häufige Fragen

Es gibt drei typische Gründe:

Es ist keine gültige SVG. Die Datei ist beschädigt oder ein anderes Format mit der Endung .svg. Öffne sie in einem Vektorprogramm und exportiere sie neu als SVG.
Es ist ein älterer Adobe-Illustrator-Export mit eigenen Entities. Exportiere neu und wähle eine einfache SVG ohne diese Entities (in Illustrator: Datei → Exportieren → Exportieren als → SVG).
Sie ist größer als die Grenze. Erhöhe Maximale SVG-Größe (MB) unter Icons → Einstellungen oder mach die Datei kleiner.

Passende Anleitungen

SVG-Cleaner (Pro)

SVGs finden und bereinigen, die am Uploader vorbeikamen.

Icon-Bibliothek

Icons für den Icon-Block sammeln.

Für Entwickler: Allow-Liste, Größengrenze und die zusätzlichen Prüfungen stehen in der Entwickler-Referenz.

Was this page helpful?