YouTube embed-parameters zijn de query-string-opties die precies bepalen hoe een ingesloten video eruitziet en zich gedraagt. Deze gids loopt twaalf van de nuttigste stuk voor stuk door, met een werkend voorbeeld voor elk, zodat je precies ziet wat elke parameter verandert.
Hoe parameters aan een embed-URL worden gekoppeld
Elke parameter wordt toegevoegd aan de embed-URL als een sleutel-waardepaar, gekoppeld met een ampersand: https://www.youtube-nocookie.com/embed/VIDEO_ID?param1=value1¶m2=value2. Je kunt er zoveel combineren als je wilt. Boolean-achtige parameters gebruiken over het algemeen 1 voor “aan” en 0 voor “uit”, en het volledig weglaten van een parameter valt terug op YouTube’s eigen standaardgedrag daarvoor.
1. autoplay
Start de video zodra de speler laadt, zonder dat een bezoeker op afspelen hoeft te drukken.
https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1De meeste browsers blokkeren automatisch afspelende video met geluid tenzij de bezoeker al met je site heeft geïnteracteerd, dus autoplay wordt bijna altijd gecombineerd met mute.
2. mute
Start de speler gedempt, wat ervoor zorgt dat autoplay betrouwbaar werkt in alle browsers.
https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1&mute=13. start
Begint het afspelen op een specifiek aantal seconden in de video, in plaats van vanaf het begin.
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=90Negentig seconden in dit voorbeeld betekent dat de speler direct opent op het punt van 1:30.
4. end
Stopt het afspelen op een specifiek aantal seconden, handig om alleen een relevant fragment van een langere video te tonen.
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=30&end=90Gecombineerd met start speelt dit alleen het venster van 30 tot 90 seconden af en stopt daarna.
5. loop
Speelt de video automatisch opnieuw af zodra deze klaar is. Voor een enkele video (geen afspeellijst) moet je ook een playlist-parameter toevoegen die is ingesteld op dezelfde video-ID, anders werkt loopen stilzwijgend niet.
https://www.youtube-nocookie.com/embed/VIDEO_ID?loop=1&playlist=VIDEO_ID6. controls
Toont of verbergt de bedieningsbalk van de speler (afspelen/pauzeren, volume, voortgang, volledig scherm).
https://www.youtube-nocookie.com/embed/VIDEO_ID?controls=0Dit instellen op 0 is gebruikelijk voor video’s die als achtergrond dienen, waarbij je geen zichtbare afspeelbediening wilt.
7. rel
Bepaalt welke gerelateerde video’s worden voorgesteld zodra het afspelen eindigt. Dit instellen op 0 beperkt suggesties tot video’s van hetzelfde kanaal in plaats van YouTube’s bredere aanbevelingenpool.
https://www.youtube-nocookie.com/embed/VIDEO_ID?rel=08. list (en het videoseries-pad)
Laadt een volledige afspeellijst in plaats van een enkele video. Dit wordt gecombineerd met het /embed/videoseries-pad in plaats van een enkele video-ID.
https://www.youtube-nocookie.com/embed/videoseries?list=PLAYLIST_ID9. index
Wordt samen met een afspeellijst gebruikt om te kiezen bij welk item wordt gestart, tellend vanaf 0 voor de eerste video.
https://www.youtube-nocookie.com/embed/videoseries?list=PLAYLIST_ID&index=2Dit voorbeeld start bij de derde video in de afspeellijst.
10. hl
Stelt de taal in van de eigen interface-elementen van de speler (niet de audio of ondertiteling van de video), met een standaard taalcode.
https://www.youtube-nocookie.com/embed/VIDEO_ID?hl=de11. cc_load_policy
Dwingt ondertiteling standaard af te tonen wanneer ingesteld op 1, handig voor toegankelijkheidsgerichte embeds of video’s met geluidloze autoplay waarbij de ondertiteling de betekenis draagt.
https://www.youtube-nocookie.com/embed/VIDEO_ID?cc_load_policy=112. color
Stelt de kleur in van de voortgangsbalk van de speler, met rood of wit als mogelijke waarden.
https://www.youtube-nocookie.com/embed/VIDEO_ID?color=whiteMeerdere parameters combineren
Parameters kunnen vrij worden gestapeld. Een privacyvriendelijk, responsief, automatisch afspelend achtergrondfragment dat geluidloos loopt en de bediening verbergt, zou er zo uit kunnen zien:
https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1&mute=1&controls=0&loop=1&playlist=VIDEO_ID&rel=0Overzichtstabel
| Parameter | Waarden | Wat het doet |
|---|---|---|
| autoplay | 0 / 1 | Start het afspelen automatisch |
| mute | 0 / 1 | Start gedempt, vereist voor betrouwbare autoplay |
| start | seconden | Startpunt van het afspelen |
| end | seconden | Stoppunt van het afspelen |
| loop | 0 / 1 | Speelt de video opnieuw af (heeft playlist-parameter nodig voor een enkele video) |
| controls | 0 / 1 | Toont of verbergt de bedieningsbalk |
| rel | 0 / 1 | Beperkt suggesties na afloop tot hetzelfde kanaal |
| list | afspeellijst-ID | Laadt een volledige afspeellijst via /embed/videoseries |
| index | getal | Bij welk afspeellijstitem wordt gestart |
| hl | taalcode | Interfacetaal van de speler |
| cc_load_policy | 0 / 1 | Dwingt ondertiteling standaard aan |
| color | red / white | Kleur van de voortgangsbalk |
Gerelateerde artikelen
Voor de opmaakkant van embedden, zie onze gids over responsieve YouTube embeds. Voor privacy, zie YouTube-video’s insluiten zonder cookies. Voor troubleshooting, zie YouTube-video wordt niet ingesloten: 8 oplossingen.
Parameters die vaak met elkaar worden verward
Een paar van deze twaalf parameters worden vaak genoeg door elkaar gehaald om een directe vergelijking te rechtvaardigen. autoplay en loop klinken vergelijkbaar maar doen iets anders: autoplay bepaalt of het afspelen begint bij het laden, loop bepaalt of het opnieuw begint na afloop, en ze worden vaak samen gebruikt maar zijn onafhankelijke instellingen. start en index zijn ook makkelijk te verwarren: start is een tijdsverschuiving in seconden binnen een enkele video, terwijl index een positie binnen een afspeellijst is, geteld in items in plaats van tijd. Deze correct koppelen is belangrijk, want als je ze verkeerd combineert (bijvoorbeeld index proberen te gebruiken bij een embed van een enkele video), heeft dat simpelweg geen effect in plaats van een foutmelding te geven.
Parameters met beperkte of inconsistente ondersteuning
Niet elke parameter gedraagt zich identiek in elke context. modestbranding, dat de aanwezigheid van YouTube’s logo vermindert, heeft inconsistente effecten gehad in verschillende versies van de speler en wordt over het algemeen beschouwd als een best-effort-instelling in plaats van een gegarandeerde. Ook kunnen sommige weergavegerelateerde parameters zich enigszins anders gedragen afhankelijk van of een bezoeker is ingelogd op een Google-account in zijn browser, aangezien voorkeuren op accountniveau kunnen interacteren met standaardinstellingen van de speler. De hierboven behandelde afspeelbedieningsparameters, start, end, autoplay, mute, loop en controls, zijn het meest consistent betrouwbaar in alle browsers en accountstatussen, en daarom zijn dit de parameters waarop het de moeite waard is je embedstrategie te bouwen.
Een uitgewerkt voorbeeld: stap voor stap een embed voor een cursuspagina bouwen
Stel dat je een lesvideo insluit op een cursuspagina en deze privacyvriendelijk en responsief wilt, startend op de tweeminutenmarkering waar de daadwerkelijke lesinhoud begint (een kanaalintro overslaand), met standaard ondertiteling aan voor toegankelijkheid, en zonder autoplay omdat een bezoeker zelf zou moeten kiezen om te starten. Als je de parameters doorloopt: privacyvriendelijk betekent het domein youtube-nocookie.com; responsief betekent een op percentages gebaseerde wrapper in plaats van vaste afmetingen; starten op twee minuten betekent start=120; standaard ondertiteling betekent cc_load_policy=1; en geen autoplay betekent simpelweg de autoplay-parameter weglaten, aangezien dat de standaardstatus is. De resulterende embed-URL zou zijn:
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=120&cc_load_policy=1&rel=0Dit ene voorbeeld laat zien hoe de parameters uit deze gids op natuurlijke wijze samenkomen om een specifieke, realistische behoefte op te lossen, in plaats van te bestaan als een abstracte lijst.
Je parametercombinaties testen
Voordat je een embed met meerdere gecombineerde parameters publiceert, is het de moeite waard deze direct te testen in plaats van aan te nemen dat de combinatie werkt zoals verwacht. Plak de volledige embed-URL, parameters en al, direct in een browsertab; de speler zou zich precies zo moeten gedragen als binnen de iframe van je pagina, waardoor je typefouten in parameternamen kunt opsporen (een veelgemaakte fout, aangezien een verkeerd gespelde parameter meestal gewoon stilzwijgend wordt genegeerd in plaats van als fout te worden gemarkeerd) voordat ze je live site bereiken.
Parameters en privacy: welke interacteren met het nocookie-domein
Het is de moeite waard te verduidelijken dat elke parameter in deze gids identiek werkt, of je nu het standaard youtube.com embed-domein gebruikt of het privacyverbeterde domein youtube-nocookie.com. De keuze van het domein en de afspeelparameters zijn volledig onafhankelijke beslissingen: overschakelen naar het privacyverbeterde domein schakelt geen van de parameters autoplay, mute, start, end, loop, controls, rel, list, index, hl, cc_load_policy of color uit of wijzigt deze. Dit is een veelvoorkomend punt van verwarring dat het waard is om direct aan te pakken, aangezien sommige site-eigenaren aannemen dat de privacymodus een uitgeklede versie van de speler is met minder opties, terwijl deze in de praktijk functioneel identiek is, alleen met ander cookiegedrag aan de kant van Google.
Je eigen parameteroverzicht bouwen voor een specifiek project
Voor een grotere site met veel ingesloten video’s is het de moeite waard om intern te documenteren welke combinatie van deze twaalf parameters je team standaard gebruikt, in plaats van de keuze voor elke nieuwe embed opnieuw te bedenken. Een eenvoudige interne standaard, bijvoorbeeld: gebruik altijd het privacyverbeterde domein, neem altijd rel=0 op, standaard geen autoplay tenzij een specifiek paginatype daarom vraagt, en gebruik altijd een responsieve wrapper, houdt embeds consistent op een site en maakt het veel sneller om een verkeerd geconfigureerde embed op te sporen tijdens een review. Deze lijst van twaalf parameters behandelen als een menu om standaardwaarden uit te kiezen, in plaats van een eenmalige beslissing die telkens opnieuw wordt genomen, betaalt zich uit naarmate de videocontent van een site groeit.
Een laatste woord over deze referentie bij de hand houden
Deze pagina, of specifiek de overzichtstabel hierboven, bookmarken is waarschijnlijk nuttiger dan proberen alle twaalf parameters volledig uit het hoofd te leren. In de praktijk gebruikt de meeste embeds op een typische site slechts drie of vier hiervan tegelijk (meestal impliciet een privacyverbeterd domein, rel=0, en af en toe start of autoplay/mute samen), dus met de volledige lijst als naslagwerk voor de minder gangbare gevallen, zoals afspeellijsten of ondertiteling, dek je de overige situaties af zonder alles vooraf uit het hoofd te hoeven kennen.
Hoe YouTube’s eigen documentatie zich verhoudt tot deze gids
YouTube publiceert zijn eigen ontwikkelaarsdocumentatie over de IFrame Player API en embed-parameters, primair gericht op ontwikkelaars die aangepaste, met JavaScript aangestuurde spelers bouwen in plaats van site-eigenaren die een eenvoudige embed aan een pagina toevoegen. Deze gids richt zich specifiek op de subset parameters die relevant zijn voor een standaard iframe-embed zonder aangepaste JavaScript, wat de overgrote meerderheid van praktijkgevallen op gewone websites dekt. Voor iedereen die geavanceerdere, programmatisch aangestuurde video-ervaringen bouwt (aangepaste afspeelknoppen, voortgang bijhouden, gesynchroniseerde meerdere-video-spelers), is YouTube’s eigen IFrame Player API-documentatie de volgende stap voorbij wat een aanpak op basis van query-string-parameters zoals deze kan bieden.
Een afsluitende samenvatting van de twaalf parameters
Over autoplay, mute, start, end, loop, controls, rel, list, index, hl, cc_load_policy en color heen is de praktische conclusie dat een klein handjevol (keuze van privacydomein, rel en een responsieve wrapper) een verstandige standaard vormt voor bijna elke embed, terwijl de rest (start/end, loop, shorts-opmaak, afspeellijsten, ondertiteling, taal en kleur) situationele hulpmiddelen zijn waar je alleen naar hoeft te grijpen wanneer een specifieke pagina daar daadwerkelijk om vraagt, in plaats van ze willekeurig aan elke embed op een site toe te voegen.
Bouw er nu een
Gratis tool
Sla de handmatige query strings over. Plak een link en zet de opties aan die je nodig hebt.
Deze referentie binnen handbereik houden betekent dat je nooit naar parameternamen uit je geheugen hoeft te gokken wanneer een nieuwe embedbehoefte zich voordoet.
Veelgestelde vragen
Werken al deze parameters zonder conflicten samen?
Ja, ze kunnen over het algemeen vrij worden gecombineerd. De belangrijkste afhankelijkheid om te onthouden is dat loop een bijbehorende playlist-parameter nodig heeft om te werken bij een enkele video.
Zijn er parameters die niet meer werken?
Een paar oudere parameters uit oudere tutorials, zoals showinfo, zijn in de loop van de tijd door YouTube afgeschaft en hebben geen zichtbaar effect meer.
Moet ik deze uit mijn hoofd leren om ze te gebruiken?
Nee. Onze gratis embed code generator biedt de nuttigste parameters als eenvoudige schakelaars en velden en bouwt de URL voor je op.
Wat gebeurt er als ik een parameternaam verkeerd spel?
YouTube’s speler negeert over het algemeen parameters die het niet herkent in plaats van een zichtbare fout te geven, dus een typefout heeft stilzwijgend geen effect, wat is waarom het testen van je exacte embed-URL de moeite waard is.
Kan ik een standaardvolumeniveau instellen met een parameter?
Nee, er is geen parameter voor een specifiek standaardvolumeniveau; de speler start ofwel gedempt (via de mute-parameter) of op het laatst gebruikte volumeniveau van de kijker zelf.
Werken deze parameters hetzelfde op mobiel?
Over het algemeen wel, hoewel mobiele browsers hun eigen aanvullende autoplay-beperkingen toepassen bovenop die van YouTube zelf, waardoor gedempte autoplay op mobiel nog consistenter vereist is dan op desktop.
Kan ik deze parameters wijzigen nadat een video al op mijn pagina is ingesloten?
Ja, aangezien de parameters simpelweg in de src-URL van de iframe staan, heeft het bewerken van de HTML op je pagina en opnieuw publiceren direct effect voor iedereen die de pagina daarna laadt.
Is er een maximum aantal parameters dat ik kan combineren?
Geen praktisch limiet; URL’s kunnen veel parameters bevatten, en alle twaalf hier behandelde parameters kunnen technisch tegelijk op een enkele embed worden gecombineerd, hoewel niet elke combinatie samen zinvol is.