<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>-Element von HTML repräsentiert Metadaten, die nicht von anderen metadatenbezogenen Elementen dargestellt werden können, wie z. B. <base>, <link>, <script>, <style> oder <title>.

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

Wenn das name-Attribut gesetzt ist, bietet das <meta>-Element dokumentweite Metadaten, die für die gesamte Seite gelten.
Wenn das http-equiv-Attribut gesetzt ist, agiert 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 Zeichencodierung angibt, in der das Dokument kodiert ist.
Wenn das itemprop-Attribut gesetzt ist, bietet das <meta>-Element benutzerdefinierte Metadaten.

Attribute

Dieses Element umfasst die globalen Attribute.

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

charset: Dieses Attribut deklariert die Zeichencodierung des Dokuments. Wenn das Attribut vorhanden ist, muss sein Wert eine ASCII-fallunabhängige Übereinstimmung mit der Zeichenfolge "utf-8" sein, da UTF-8 die einzige gültige Kodierung für HTML5-Dokumente ist. <meta>-Elemente, die eine Zeichencodierung deklarieren, müssen vollständig innerhalb der ersten 1024 Bytes des Dokuments platziert werden.
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 sind. Der Name des Attributs ist eine Abkürzung für http-equivalent, da die erlaubten Werte Namen von gleichwertigen HTTP-Headern sind.
media: Das media-Attribut definiert, auf welche Medien die im content-Attribut definierte Farbgestaltung angewendet werden soll. Sein Wert ist eine Media Query, die standardmäßig auf all gesetzt ist, wenn 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 Namen der Metadaten angibt und das content-Attribut den Wert.

Beispiele

Eine Meta-Beschreibung festlegen

Das 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." />

Eine Seitenumleitung einrichten

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

html

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

Technische Zusammenfassung

Inhaltskategorien	Metadatenelemente. Wenn das `itemprop`-Attribut vorhanden ist: Flussinhalte, Phrase-Inhalte.
Erlaubter Inhalt	Keiner; es ist ein leeres Element.
Tag-Weglassung	Es muss einen Start-Tag haben und darf keinen End-Tag haben.
Erlaubte Eltern	`<meta charset>`, `<meta http-equiv>`: ein `<head>`-Element. Wenn der `http-equiv` keine Kodierungsdeklaration ist, kann es auch innerhalb eines `<noscript>`-Elements, selbst innerhalb eines `<head>`-Elements sein. `<meta name>`: jedes Element, das Metadateninhalt akzeptiert. `<meta itemprop>`: jedes Element, das Metadateninhalt oder Flussinhalt akzeptiert.
Implizite ARIA-Rolle	Keine entsprechende Rolle
Erlaubte ARIA-Rollen	Keine `role` erlaubt
DOM-Schnittstelle	[`HTMLMetaElement`](/de/docs/Web/API/HTMLMetaElement)

Spezifikationen

Specification
HTML # the-meta-element