<meta>: Das Metadaten-Element

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

Das <meta>-HTML-Element repräsentiert Metadaten, die nicht durch andere metabezogene Elemente wie <base>, <link>, <script>, <style> oder <title> dargestellt werden können.

Der Typ der vom <meta>-Element bereitgestellten Metadaten kann einer der folgenden sein:

Wenn das name-Attribut gesetzt ist, bietet das <meta>-Element Dokumentenebene-Metadaten, die für die gesamte Seite gelten.
Wenn das http-equiv-Attribut gesetzt ist, fungiert das <meta>-Element als Pragma-Direktive, um Direktiven zu simulieren, die sonst durch einen HTTP-Header gegeben werden könnten.
Wenn das charset-Attribut gesetzt ist, ist das <meta>-Element eine Zeichensatzdeklaration, die die Zeichenkodierung angibt, in der das Dokument kodiert ist.
Wenn das itemprop-Attribut gesetzt ist, bietet das <meta>-Element benutzerdefinierte Metadaten.

Attribute

Dieses Element enthält die globalen Attribute.

Hinweis: Das name-Attribut hat eine spezifische Bedeutung für das <meta>-Element. Das itemprop-Attribut darf nicht auf ein <meta>-Element gesetzt werden, das ein name-, http-equiv- oder charset-Attribut enthält.

charset: Dieses Attribut deklariert die Zeichenkodierung des Dokuments. Wenn das Attribut vorhanden ist, muss sein Wert insensitiv gegenüber Groß-/Kleinschreibung mit der Zeichenfolge "utf-8" übereinstimmen, da UTF-8 die einzige gültige Kodierung für HTML5-Dokumente ist. <meta>-Elemente, die eine Zeichensatzkodierung deklarieren, müssen sich vollständig innerhalb der ersten 1024 Bytes des Dokuments befinden.
content: Dieses Attribut enthält den Wert für das http-equiv- oder name-Attribut, je nachdem, welches verwendet wird.
http-equiv: Definiert eine Pragma-Direktive, die Anweisungen für den Browser zur Verarbeitung des Dokuments enthält. Der Attributname steht für http-equivalent, weil die erlaubten Werte Namen von gleichwertigen HTTP-Headern sind.
media: Das media-Attribut definiert, auf welche Medien die im content-Attribut definierte Themenfarbe angewendet werden soll. Sein Wert ist eine Media Query, die standardmäßig auf all gesetzt ist, falls das Attribut fehlt. Dieses Attribut ist nur relevant, wenn das name-Attribut des Elements auf theme-color gesetzt ist. Andernfalls hat es keine Wirkung und sollte nicht enthalten sein.
name: Die Attribute name und content können zusammen verwendet werden, um Dokumentmetadaten in Form von Name-Wert-Paaren bereitzustellen, wobei das name-Attribut den Metadaten-Namen und das content-Attribut den Wert angibt.

Beispiele

Setzen einer Meta-Beschreibung

Der folgende <meta>-Tag bietet eine description als Metadaten für die Webseite:

html

<meta
  name="description"
  content="The HTML reference describes all elements and attributes of HTML, including global attributes that apply to all elements." />

Setzen einer Seitenweiterleitung

Das folgende Beispiel verwendet http-equiv="refresh", um den Browser anzuweisen, eine Weiterleitung durchzuführen. Das content="3;url=https://www.mozilla.org"-Attribut leitet die Seite nach 3 Sekunden auf https://www.mozilla.org weiter:

html

<meta http-equiv="refresh" content="3;url=https://www.mozilla.org" />

Technische Zusammenfassung

Inhaltskategorien	Metadaten-Inhalt. Wenn das `itemprop`-Attribut vorhanden ist: Fluss-Inhalt, Phrasen-Inhalt.
Erlaubter Inhalt	Keine; es ist ein leeres Element.
Tag-Auslassung	Muss einen Starttag haben und darf keinen Endtag haben.
Erlaubte Eltern	`<meta charset>`, `<meta http-equiv>`: ein `<head>`-Element. Wenn `http-equiv` keine Kodierungsdeklaration ist, kann es auch innerhalb eines `<noscript>`-Elements enthalten sein, das sich innerhalb eines `<head>`-Elements befindet. `<meta name>`: jedes Element, das Metadaten-Inhalte akzeptiert. `<meta itemprop>`: jedes Element, das Metadaten-Inhalte oder Fluss-Inhalte akzeptiert.
Implizite ARIA-Rolle	Keine entsprechende Rolle
Zulässige ARIA-Rollen	Keine `role` erlaubt
DOM-Schnittstelle	[`HTMLMetaElement`](/de/docs/Web/API/HTMLMetaElement)

Spezifikationen

Specification
HTML # the-meta-element