YouTube-Embed-Parameter sind die Query-String-Optionen, die genau steuern, wie ein eingebettetes Video aussieht und sich verhält. Diese Anleitung geht zwölf der nützlichsten einzeln durch, jeweils mit einem funktionierenden Beispiel, damit du genau siehst, was jeder davon verändert.
Wie Parameter an eine Embed-URL angehängt werden
Jeder Parameter wird der Embed-URL als Schlüssel-Wert-Paar hinzugefügt, verbunden mit einem kaufmännischen Und: https://www.youtube-nocookie.com/embed/VIDEO_ID?param1=value1¶m2=value2. Du kannst so viele kombinieren, wie du möchtest. Boolesche Parameter nutzen im Allgemeinen 1 für „an“ und 0 für „aus“, und lässt du einen Parameter ganz weg, gilt dafür das jeweilige Standardverhalten von YouTube.
1. autoplay
Startet das Video in dem Moment, in dem der Player lädt, ohne dass ein Besucher auf Play drückt.
https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1Die meisten Browser blockieren autoplayendes Video mit Ton, sofern der Besucher nicht bereits mit deiner Seite interagiert hat, weshalb autoplay fast immer mit mute kombiniert wird.
2. mute
Startet den Player stumm, was Autoplay browserübergreifend zuverlässig funktionieren lässt.
https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1&mute=13. start
Beginnt die Wiedergabe bei einer bestimmten Sekundenzahl im Video, statt von vorn.
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=90Neunzig Sekunden bedeuten in diesem Beispiel, dass der Player direkt bei Minute 1:30 öffnet.
4. end
Stoppt die Wiedergabe bei einer bestimmten Sekundenzahl, nützlich um nur einen relevanten Ausschnitt eines längeren Videos zu zeigen.
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=30&end=90Kombiniert mit start spielt das nur das Fenster von 30 bis 90 Sekunden ab und stoppt dann.
5. loop
Wiederholt das Video automatisch nach dem Ende. Bei einem einzelnen Video (keiner Playlist) musst du außerdem einen playlist-Parameter mit derselben Video-ID setzen, sonst funktioniert die Schleife stillschweigend nicht.
https://www.youtube-nocookie.com/embed/VIDEO_ID?loop=1&playlist=VIDEO_ID6. controls
Zeigt oder verbirgt die Steuerleiste des Players (Play/Pause, Lautstärke, Fortschritt, Vollbild).
https://www.youtube-nocookie.com/embed/VIDEO_ID?controls=0Diesen Wert auf 0 zu setzen ist üblich bei Video im Hintergrundstil, bei dem keine sichtbaren Wiedergabe-Steuerelemente gewünscht sind.
7. rel
Steuert, welche verwandten Videos nach Ende der Wiedergabe vorgeschlagen werden. Diesen Wert auf 0 zu setzen begrenzt Vorschläge auf Videos desselben Kanals statt des breiteren Empfehlungspools von YouTube.
https://www.youtube-nocookie.com/embed/VIDEO_ID?rel=08. list (und der videoseries-Pfad)
Lädt eine ganze Playlist statt eines einzelnen Videos. Das wird mit dem Pfad /embed/videoseries statt einer einzelnen Video-ID kombiniert.
https://www.youtube-nocookie.com/embed/videoseries?list=PLAYLIST_ID9. index
Wird zusammen mit einer Playlist genutzt, um auszuwählen, bei welchem Eintrag gestartet wird, gezählt ab 0 für das erste Video.
https://www.youtube-nocookie.com/embed/videoseries?list=PLAYLIST_ID&index=2Dieses Beispiel startet beim dritten Video der Playlist.
10. hl
Legt die Sprache der eigenen Oberflächenelemente des Players fest (nicht das Audio oder die Untertitel des Videos), mit einem standardmäßigen Sprachcode.
https://www.youtube-nocookie.com/embed/VIDEO_ID?hl=de11. cc_load_policy
Erzwingt bei 1 die Standardanzeige von Untertiteln, nützlich für barrierefreiheitsorientierte Embeds oder stummes Autoplay-Video, bei dem Untertitel die Bedeutung tragen.
https://www.youtube-nocookie.com/embed/VIDEO_ID?cc_load_policy=112. color
Legt die Farbe der Fortschrittsleiste des Players fest, akzeptiert entweder red oder white als Wert.
https://www.youtube-nocookie.com/embed/VIDEO_ID?color=whiteMehrere Parameter kombinieren
Parameter lassen sich frei stapeln. Ein datenschutzfreundlicher, responsiver, automatisch abspielender Hintergrund-Clip, der stumm in Schleife läuft und die Steuerelemente ausblendet, könnte so aussehen:
https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1&mute=1&controls=0&loop=1&playlist=VIDEO_ID&rel=0Referenztabelle
| Parameter | Werte | Was er bewirkt |
|---|---|---|
| autoplay | 0 / 1 | Startet die Wiedergabe automatisch |
| mute | 0 / 1 | Startet stumm, nötig für zuverlässiges Autoplay |
| start | Sekunden | Startpunkt der Wiedergabe |
| end | Sekunden | Stopppunkt der Wiedergabe |
| loop | 0 / 1 | Wiederholt das Video (braucht playlist-Parameter bei Einzelvideo) |
| controls | 0 / 1 | Zeigt oder verbirgt die Steuerleiste |
| rel | 0 / 1 | Begrenzt Vorschläge am Ende auf denselben Kanal |
| list | Playlist-ID | Lädt eine ganze Playlist über /embed/videoseries |
| index | Zahl | Bei welchem Playlist-Eintrag gestartet wird |
| hl | Sprachcode | Sprache der Player-Oberfläche |
| cc_load_policy | 0 / 1 | Erzwingt Untertitel standardmäßig an |
| color | red / white | Farbe der Fortschrittsleiste |
Weiterführende Artikel
Zum Layout-Teil des Einbettens siehe unsere Anleitung zu responsiven YouTube-Embeds. Zum Datenschutz siehe YouTube-Videos ohne Cookies einbetten. Zur Fehlerbehebung siehe YouTube-Video lässt sich nicht einbetten: 8 Lösungen.
Parameter, die häufig miteinander verwechselt werden
Ein paar dieser zwölf Parameter werden oft genug vertauscht, um einen direkten Vergleich zu rechtfertigen. autoplay und loop klingen ähnlich, erfüllen aber unterschiedliche Aufgaben: autoplay steuert, ob die Wiedergabe beim Laden startet, loop steuert, ob sie nach dem Ende neu startet, und sie werden häufig zusammen genutzt, sind aber unabhängige Einstellungen. start und index werden ebenfalls leicht verwechselt: start ist ein Zeitversatz in Sekunden innerhalb eines einzelnen Videos, während index eine Position innerhalb einer Playlist ist, gezählt in Einträgen statt Zeit. Diese korrekt zuzuordnen ist wichtig, denn eine Verwechslung (etwa index bei einem Einzelvideo-Embed zu nutzen) hat einfach keine Wirkung, statt einen Fehler zu erzeugen.
Parameter mit eingeschränkter oder uneinheitlicher Unterstützung
Nicht jeder Parameter verhält sich in jedem Kontext identisch. modestbranding, das die Sichtbarkeit des YouTube-Logos reduziert, hat sich über verschiedene Player-Versionen hinweg uneinheitlich verhalten und gilt allgemein eher als Best-Effort-Einstellung denn als Garantie. Ähnlich können sich manche anzeigebezogene Parameter je nachdem, ob ein Besucher im Browser bei einem Google-Konto eingeloggt ist, leicht anders verhalten, da kontobezogene Einstellungen mit den Player-Standardwerten interagieren können. Die oben behandelten Parameter zur Wiedergabesteuerung, start, end, autoplay, mute, loop und controls, sind über Browser und Kontostatus hinweg am zuverlässigsten, weshalb sich eine Embed-Strategie am besten auf sie stützt.
Ein durchgerechnetes Beispiel: Schritt für Schritt ein Kursseiten-Embed bauen
Stell dir vor, du bettest ein Lektionsvideo auf einer Kursseite ein und möchtest es datenschutzfreundlich, responsiv, beginnend bei Minute zwei, wo der eigentliche Lektionsinhalt anfängt (nach einem Kanal-Intro), mit standardmäßig aktivierten Untertiteln für Barrierefreiheit, und ohne Autoplay, da ein Besucher es selbst starten sollte. Die Parameter durchgegangen: datenschutzfreundlich bedeutet die Domain youtube-nocookie.com; responsiv bedeutet einen prozentbasierten Wrapper statt fester Maße; Start bei zwei Minuten bedeutet start=120; standardmäßige Untertitel bedeuten cc_load_policy=1; und kein Autoplay bedeutet, den autoplay-Parameter einfach wegzulassen, da das der Standardzustand ist. Die entstehende Embed-URL wäre:
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=120&cc_load_policy=1&rel=0Dieses eine Beispiel zeigt, wie die in dieser Anleitung behandelten Parameter sich natürlich kombinieren, um eine konkrete, realistische Anforderung zu lösen, statt als abstrakte Liste zu existieren.
Deine Parameterkombinationen testen
Bevor du ein Embed mit mehreren kombinierten Parametern veröffentlichst, lohnt es sich, es direkt zu testen, statt anzunehmen, die Kombination funktioniere wie erwartet. Füge die vollständige Embed-URL, mit allen Parametern, direkt in einen Browser-Tab ein; der Player sollte sich genauso verhalten wie im Iframe deiner Seite, wodurch du Tippfehler in Parameternamen abfangen kannst (ein häufiger Fehler, da ein falsch geschriebener Parameter meist stillschweigend ignoriert wird statt als Fehler gemeldet), bevor sie auf deine Live-Website gelangen.
Parameter und Datenschutz: Welche mit der Nocookie-Domain interagieren
Es lohnt sich klarzustellen, dass jeder in dieser Anleitung behandelte Parameter identisch funktioniert, egal ob du die Standard-Domain youtube.com oder die datenschutzfreundliche Domain youtube-nocookie.com für das Embed nutzt. Die Wahl der Domain und die Wiedergabeparameter sind vollständig unabhängige Entscheidungen: Der Wechsel zur datenschutzfreundlichen Domain deaktiviert oder verändert keinen von autoplay, mute, start, end, loop, controls, rel, list, index, hl, cc_load_policy oder color. Das ist ein häufiger Punkt der Verwirrung, den es wert ist, direkt anzusprechen, da manche Website-Betreiber annehmen, der Datenschutzmodus sei eine abgespeckte Version des Players mit weniger Optionen, während er funktional tatsächlich identisch ist, nur mit anderem Cookie-Verhalten auf Google-Seite.
Eine eigene Parameter-Referenz für ein bestimmtes Projekt aufbauen
Für eine größere Website mit vielen eingebetteten Videos lohnt es sich, intern zu dokumentieren, welche Kombination dieser zwölf Parameter dein Team standardmäßig verwendet, statt die Wahl bei jedem neuen Embed neu zu treffen. Ein einfacher interner Standard, zum Beispiel: immer die datenschutzfreundliche Domain nutzen, immer rel=0 einschließen, standardmäßig kein Autoplay, sofern ein bestimmter Seitentyp es nicht erfordert, und immer einen responsiven Wrapper nutzen, hält Embeds über eine Website hinweg konsistent und macht es deutlich schneller, ein fehlerhaft konfiguriertes bei einer Überprüfung zu erkennen. Diese Liste von zwölf Parametern als Menü zu behandeln, aus dem Standardwerte gewählt werden, statt als jedes Mal neu getroffene Einzelentscheidung, zahlt sich aus, wenn die Videoinhalte einer Website wachsen.
Ein letztes Wort zum griffbereiten Halten dieser Referenz
Diese Seite, oder speziell die obige Referenztabelle, zu speichern ist wahrscheinlich nützlicher, als zu versuchen, alle zwölf Parameter auswendig zu lernen. In der Praxis nutzen die meisten Embeds einer typischen Website nur drei oder vier davon gleichzeitig (üblicherweise implizit eine datenschutzfreundliche Domain, rel=0, und gelegentlich start oder autoplay/mute zusammen), sodass die vollständige Liste für die selteneren Fälle wie Playlists oder Untertitel griffbereit zu haben die übrigen Situationen abdeckt, ohne alles vorab auswendig lernen zu müssen.
Wie sich die eigene Dokumentation von YouTube zu dieser Anleitung verhält
YouTube veröffentlicht eine eigene Entwicklerdokumentation zur IFrame-Player-API und den Embed-Parametern, primär gerichtet an Entwickler, die eigene, per JavaScript gesteuerte Player bauen, statt an Website-Betreiber, die einer Seite ein einfaches Embed hinzufügen. Diese Anleitung konzentriert sich speziell auf die Teilmenge der Parameter, die für ein Standard-Iframe-Embed ohne eigenes JavaScript relevant sind, was die große Mehrheit der realen Anwendungsfälle auf gewöhnlichen Websites abdeckt. Für alle, die fortgeschrittenere, programmatisch gesteuerte Video-Erlebnisse bauen (eigene Play-Buttons, Fortschritts-Tracking, synchronisierte Multi-Video-Player), ist die eigene IFrame-Player-API-Dokumentation von YouTube der nächste Schritt über das hinaus, was ein Ansatz mit Query-String-Parametern wie diesem bieten kann.
Eine abschließende Zusammenfassung der zwölf Parameter
Über autoplay, mute, start, end, loop, controls, rel, list, index, hl, cc_load_policy und color hinweg ist die praktische Erkenntnis, dass eine kleine Handvoll (Wahl der Datenschutz-Domain, rel und ein responsiver Wrapper) für fast jedes Embed einen sinnvollen Standard bildet, während der Rest (start/end, loop, Shorts-Formatierung, Playlists, Untertitel, Sprache und Farbe) situative Werkzeuge sind, zu denen es sich lohnt zu greifen, nur wenn eine bestimmte Seite sie tatsächlich braucht, statt sie wahllos jedem Embed einer Website hinzuzufügen.
Jetzt eines erstellen
Kostenloses Tool
Überspringe die manuellen Query-Strings. Link einfügen und die gewünschten Optionen aktivieren.
Diese Referenz griffbereit zu halten bedeutet, nie mehr Parameternamen aus dem Gedächtnis raten zu müssen, wenn ein neuer Einbett-Bedarf entsteht.
Häufig gestellte Fragen
Funktionieren all diese Parameter ohne Konflikte zusammen?
Ja, sie lassen sich im Allgemeinen frei kombinieren. Die wichtigste Abhängigkeit, die man sich merken sollte, ist, dass loop bei einem Einzelvideo einen passenden playlist-Parameter braucht, um zu funktionieren.
Gibt es Parameter, die nicht mehr funktionieren?
Ein paar ältere Parameter aus älteren Tutorials, wie showinfo, wurden von YouTube im Laufe der Zeit als veraltet markiert und haben keine sichtbare Wirkung mehr.
Muss ich mir diese merken, um sie zu nutzen?
Nein. Unser kostenloser Embed-Code-Generator stellt die nützlichsten als einfache Schalter und Felder bereit und baut die URL für dich.
Was passiert, wenn ich einen Parameternamen falsch schreibe?
Der Player von YouTube ignoriert nicht erkannte Parameter im Allgemeinen, statt einen sichtbaren Fehler zu werfen, sodass ein Tippfehler stillschweigend keine Wirkung hat, weshalb es sich lohnt, deine exakte Embed-URL direkt zu testen.
Kann ich mit einem Parameter eine Standard-Lautstärke festlegen?
Nein, es gibt keinen Parameter für eine bestimmte Standard-Lautstärke; der Player startet entweder stumm (über den mute-Parameter) oder bei der zuletzt genutzten Lautstärke des Zuschauers.
Funktionieren diese Parameter auf dem Handy genauso?
Im Allgemeinen ja, allerdings wenden mobile Browser zusätzlich zu denen von YouTube ihre eigenen Autoplay-Beschränkungen an, sodass stummgeschaltetes Autoplay auf dem Handy noch konsequenter erforderlich ist als am Desktop.
Kann ich diese Parameter ändern, nachdem ein Video bereits auf meiner Seite eingebettet ist?
Ja, da die Parameter einfach in der src-URL des Iframes stehen, wirkt sich das Bearbeiten des HTML auf deiner Seite und erneutes Veröffentlichen sofort für jeden aus, der die Seite danach lädt.
Gibt es eine maximale Anzahl an Parametern, die ich kombinieren kann?
Kein praktisches Limit; URLs können viele Parameter tragen, und alle zwölf hier behandelten lassen sich technisch gleichzeitig in einem Embed kombinieren, auch wenn nicht jede Kombination sinnvoll zusammenpasst.