De embed speler van YouTube accepteert een lange lijst URL parameters die vrijwel alles bepalen over hoe een video eruitziet en zich gedraagt zodra hij op je pagina staat. Dit overzicht verzamelt de parameters die ertoe doen, met uitleg in gewone taal en voorbeelden.
Hoe parameters werken
Elke parameter wordt aan de embed URL toegevoegd als een query string waarde, gekoppeld met een ampersand: https://www.youtube-nocookie.com/embed/VIDEO_ID?param1=waarde¶m2=waarde. Je kunt er zoveel combineren als je nodig hebt. Parameters die een 1-of-0 boolean verwachten gebruiken 1 voor “aan” en 0 voor “uit”; tenzij anders vermeld, gebruikt YouTube zijn eigen standaardgedrag als je een parameter helemaal weglaat.
Parameters voor afspeelbeheer
| Parameter | Waarden | Wat het doet |
|---|---|---|
| autoplay | 0 of 1 | Start het afspelen automatisch. De meeste browsers vereisen dat mute=1 erbij staat. |
| mute | 0 of 1 | Start de speler gedempt. Vereist door de meeste browsers om autoplay te laten werken. |
| start | seconden | Begint het afspelen op het opgegeven aantal seconden in de video. |
| end | seconden | Stopt het afspelen op het opgegeven aantal seconden. |
| loop | 0 of 1 | Herhaalt de video. Voor een enkele video voeg je ook playlist=VIDEO_ID toe (dezelfde ID), anders werkt herhalen niet. |
| controls | 0 of 1 | Toont (1, standaard) of verbergt (0) de bedieningsbalk van de speler. |
Parameters voor weergave en layout
| Parameter | Waarden | Wat het doet |
|---|---|---|
| rel | 0 of 1 | Bij 0 worden gerelateerde video suggesties aan het einde beperkt tot hetzelfde kanaal. |
| modestbranding | 0 of 1 | Vermindert de aanwezigheid van het YouTube logo in de bedieningselementen (ondersteuning verschilt per spelerversie). |
| fs | 0 of 1 | Schakelt de volledig scherm knop in (1, standaard) of uit (0). |
| cc_load_policy | 0 of 1 | Forceert dat ondertitels standaard worden getoond wanneer ingesteld op 1. |
| hl | taalcode | Stelt de interfacetaal van de speler in, bijvoorbeeld hl=nl. |
| color | red of white | Stelt de kleur van de voortgangsbalk van de video in. |
Parameters voor afspeellijsten en meerdere video’s
| Parameter | Waarden | Wat het doet |
|---|---|---|
| list | afspeellijst ID | Laadt een volledige afspeellijst. Combineer met het /embed/videoseries pad in plaats van een enkele video ID. |
| listType | playlist, user_uploads | Verandert hoe de list parameter wordt geïnterpreteerd. |
| index | getal | Bij welk item in de afspeellijst gestart wordt, tellend vanaf 0. |
Uitgewerkte voorbeelden
Privacyvriendelijk, responsive, start op 90 seconden, geen gerelateerde video’s:
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=90&rel=0Gedempte autoplay achtergrondvideo, bedieningselementen verborgen, herhalend:
https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1&mute=1&controls=0&loop=1&playlist=VIDEO_IDClip die alleen afspeelt van 30 tot 90 seconden:
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=30&end=90Een volledige afspeellijst, startend bij de derde video:
https://www.youtube-nocookie.com/embed/videoseries?list=PLAYLIST_ID&index=2Parameters die niet meer werken
Een paar oudere parameters die vroeger in embed tutorials verschenen, zoals showinfo en disablekb, zijn in de loop der jaren door YouTube verwijderd of afgeschaft. Als een parameter die je in een oude blogpost vindt geen zichtbaar effect heeft, is dat meestal de reden: de speler van YouTube is veranderd en de parameter wordt simpelweg genegeerd.
Een opmerking over betrouwbaarheid
Sommige weergavegerelateerde parameters, zoals modestbranding, worden op basis van beste inspanning toegepast en het exacte visuele effect kan veranderen naarmate YouTube zijn speler bijwerkt. De parameters voor afspeelbeheer (start, end, autoplay, mute, loop, controls) zijn het meest consistent betrouwbaar en het waard om je embedstrategie op te bouwen.
Bouw het zonder dit allemaal uit je hoofd te leren
Je hoeft deze query strings niet zelf te schrijven. Onze gratis embed code generator biedt de meest nuttige parameters, starttijd, eindtijd, autoplay, mute, loop, verborgen bedieningselementen, privacymodus, Shorts formaat en afspeellijsten, als eenvoudige schakelaars en velden, en stelt automatisch de juiste URL samen. Gebruik deze pagina als naslagwerk wanneer je precies wilt begrijpen wat een gegenereerde embed doet, of wanneer je een parameter nodig hebt die de generator niet aanbiedt en die je handmatig aan de code wilt toevoegen.
Gerelateerde artikelen
Voor de layoutkant van embedden, zie onze gids over responsive YouTube embeds. Voor de privacykant, zie YouTube video’s embedden zonder cookies.