<embed>

Zuletzt aktualisiert am 6. Februar 2026

Das <embed> Element bettet externe Inhalte wie PDFs, Bilder oder andere Plugin-Inhalte direkt in deine Webseite ein. Historisch war es die Schnittstelle zu Browser-Plugins wie Flash oder Java Applets. Heute wird es hauptsächlich für PDFs genutzt, wobei <iframe> in den meisten Fällen die bessere und modernere Wahl ist.

Grundlagen

• Void-Element: Kein schließendes Tag notwendig
• Bettet externe Ressourcen direkt in die Seite ein
• Benötigt das src-Attribut mit der URL der Ressource
• Historisch für Browser-Plugins (Flash, Java), heute meist für PDFs
• Alternative: <iframe> bietet mehr Kontrolle und Sicherheit
• Unterstützt width und height zur Größensteuerung
• Der type-Parameter hilft dem Browser, das richtige Plugin zu wählen

Syntax

<embed src="dokument.pdf" type="application/pdf" width="600" height="400">

Das <embed> Element ist ein Void-Element und wird ohne schließendes Tag geschrieben. Die Angabe des type-Attributs ist optional, aber empfohlen.

Attribute

Beispiele

PDF-Dokument einbetten

<embed
  src="handbuch.pdf"
  type="application/pdf"
  width="800"
  height="600"
>

Das ist der häufigste Anwendungsfall: Ein PDF-Dokument wird direkt in die Seite eingebettet. Beachte, dass nicht alle mobilen Browser PDF-Plugins haben.

SVG-Grafik einbetten

<embed
  src="logo.svg"
  type="image/svg+xml"
  width="200"
  height="100"
>

SVGs können mit <embed> eingebettet werden, aber auch hier ist oft <img> oder <object> die bessere Wahl.

Vollbreites PDF ohne feste Höhe

<embed
  src="bericht.pdf"
  type="application/pdf"
  style="width: 100%; min-height: 80vh;"
>

Mit CSS kannst du responsive Größen definieren. Die min-height verhindert, dass das PDF zu klein dargestellt wird.

Sicherheit

Das <embed> Element hat einige Sicherheitsaspekte, die du beachten solltest:

• Eingebettete Inhalte können Sicherheitsrisiken darstellen
• Vertraue nur Quellen, die du kontrollierst
• PDFs können JavaScript enthalten (potenzielle Gefahr)
• Historische Browser-Plugins (Flash, Java) waren häufige Angriffsvektoren
• <iframe> bietet bessere Sandbox-Optionen und mehr Sicherheitskontrolle
• Verwende HTTPS-URLs für externe Ressourcen
• Content Security Policy (CSP) kann <embed> einschränken

Empfehlung: Nutze wenn möglich <iframe> statt <embed>, da es modernere Sicherheitsfeatures bietet.

Barrierefreiheit

Das <embed> Element hat bekannte Barrierefreiheitsprobleme:

• Keine native Unterstützung für alternative Texte
• Screenreader haben oft Probleme mit eingebetteten Inhalten
• Fokus-Management funktioniert nicht immer zuverlässig
• Mobile Geräte unterstützen oft keine Plugins

Bessere Alternativen für Barrierefreiheit:

<!-- Besser: Direkter Link zum PDF -->
<a href="dokument.pdf" download>Dokument herunterladen (PDF, 2 MB)</a>

<!-- Oder mit iframe und Fallback -->
<iframe src="dokument.pdf" width="100%" height="600">
  <p>Dein Browser kann keine PDFs anzeigen.
    <a href="dokument.pdf" download>Hier herunterladen</a>
  </p>
</iframe>

Häufige Fehler

Fehlendes src-Attribut

<!-- Falsch: Kein src -->
<embed type="application/pdf">

<!-- Richtig -->
<embed src="dokument.pdf" type="application/pdf">

Das src-Attribut ist zwingend erforderlich, sonst weiß der Browser nicht, was er einbetten soll.

Schließendes Tag verwenden

<!-- Falsch: embed ist ein Void-Element -->
<embed src="file.pdf"></embed>

<!-- Richtig: Kein schließendes Tag -->
<embed src="file.pdf">

<embed> ist ein Void-Element und darf kein schließendes Tag haben.

Keine Fallback-Lösung

<!-- Problematisch: Was wenn das Plugin fehlt? -->
<embed src="wichtig.pdf">

<!-- Besser: Direkter Link als Alternative -->
<embed src="wichtig.pdf">
<p><a href="wichtig.pdf">PDF direkt öffnen</a></p>

Anders als <object> hat <embed> keine native Fallback-Unterstützung. Stelle immer einen alternativen Zugang bereit.

Browser-Kompatibilität

Das <embed> Element wird von allen modernen Browsern unterstützt, aber die Unterstützung spezifischer Inhaltstypen hängt von installierten Plugins ab.

Beachte: Die Browser-Unterstützung für das Element selbst ist vollständig, aber nicht alle Browser haben integrierte PDF-Viewer oder andere Plugin-Unterstützung. Mobile Browser haben oft gar keine Plugin-Unterstützung.

Email-Kompatibilität

Das <embed> Element wird in HTML-Emails nicht unterstützt und sollte niemals verwendet werden.

Aus Sicherheitsgründen blockieren alle Email-Clients externe Plugins und eingebettete Inhalte. Verwende stattdessen direkte Links zu Dokumenten.

Verwandte Elemente