I parametri per l’embed YouTube sono le opzioni nella query string che controllano esattamente l’aspetto e il comportamento di un video incorporato. Questa guida esamina dodici dei più utili singolarmente, con un esempio funzionante per ciascuno, così puoi vedere con precisione cosa cambia ognuno.
Come i parametri si aggiungono a un URL di embed
Ogni parametro viene aggiunto all’URL di embed come coppia chiave-valore, unita con una e commerciale: https://www.youtube-nocookie.com/embed/ID_VIDEO?param1=valore1¶m2=valore2. Puoi combinarne quanti ne vuoi. I parametri di tipo booleano usano generalmente 1 per “attivo” e 0 per “disattivo”, e omettere del tutto un parametro fa ricadere sul comportamento predefinito di YouTube per quel parametro.
1. autoplay
Avvia il video nel momento in cui il player si carica, senza che il visitatore prema play.
https://www.youtube-nocookie.com/embed/ID_VIDEO?autoplay=1La maggior parte dei browser blocca la riproduzione automatica con audio a meno che il visitatore non abbia già interagito con il tuo sito, quindi autoplay viene quasi sempre abbinato a mute.
2. mute
Avvia il player disattivato, il che è ciò che rende autoplay affidabile su tutti i browser.
https://www.youtube-nocookie.com/embed/ID_VIDEO?autoplay=1&mute=13. start
Avvia la riproduzione a un numero specifico di secondi all’interno del video, invece che dall’inizio.
https://www.youtube-nocookie.com/embed/ID_VIDEO?start=90Novanta secondi in questo esempio significa che il player si apre esattamente al minuto 1:30.
4. end
Interrompe la riproduzione a un numero specifico di secondi, utile per mostrare solo una clip rilevante di un video più lungo.
https://www.youtube-nocookie.com/embed/ID_VIDEO?start=30&end=90Combinato con start, questo riproduce solo la finestra tra i 30 e i 90 secondi e poi si ferma.
5. loop
Riproduce di nuovo il video automaticamente una volta finito. Per un singolo video (non una playlist), devi aggiungere anche un parametro playlist impostato sullo stesso ID video, altrimenti il loop non funzionerà silenziosamente.
https://www.youtube-nocookie.com/embed/ID_VIDEO?loop=1&playlist=ID_VIDEO6. controls
Mostra o nasconde la barra dei comandi del player (play/pausa, volume, avanzamento, schermo intero).
https://www.youtube-nocookie.com/embed/ID_VIDEO?controls=0Impostarlo a 0 è comune per video in stile sfondo dove non vuoi controlli di riproduzione visibili.
7. rel
Controlla quali video correlati vengono suggeriti alla fine della riproduzione. Impostarlo a 0 limita i suggerimenti ai video dello stesso canale invece del pool di raccomandazioni più ampio di YouTube.
https://www.youtube-nocookie.com/embed/ID_VIDEO?rel=08. list (e il percorso videoseries)
Carica un’intera playlist invece di un singolo video. Viene combinato con il percorso /embed/videoseries invece che con un singolo ID video.
https://www.youtube-nocookie.com/embed/videoseries?list=ID_PLAYLIST9. index
Usato insieme a una playlist per scegliere quale elemento avviare, contando da 0 per il primo video.
https://www.youtube-nocookie.com/embed/videoseries?list=ID_PLAYLIST&index=2Questo esempio avvia il terzo video della playlist.
10. hl
Imposta la lingua degli elementi dell’interfaccia del player stesso (non l’audio o i sottotitoli del video), usando un codice lingua standard.
https://www.youtube-nocookie.com/embed/ID_VIDEO?hl=it11. cc_load_policy
Forza la visualizzazione dei sottotitoli di default quando impostato a 1, utile per embed orientati all’accessibilità o per video in autoplay silenzioso dove i sottotitoli portano il significato.
https://www.youtube-nocookie.com/embed/ID_VIDEO?cc_load_policy=112. color
Imposta il colore della barra di avanzamento del player, accettando come valori red o white.
https://www.youtube-nocookie.com/embed/ID_VIDEO?color=whiteCombinare più parametri
I parametri si combinano liberamente. Una clip di sfondo rispettosa della privacy, responsive, in autoplay, che si ripete silenziosamente e nasconde i controlli potrebbe apparire così:
https://www.youtube-nocookie.com/embed/ID_VIDEO?autoplay=1&mute=1&controls=0&loop=1&playlist=ID_VIDEO&rel=0Tabella di riferimento
| Parametro | Valori | Cosa fa |
|---|---|---|
| autoplay | 0 / 1 | Avvia la riproduzione automaticamente |
| mute | 0 / 1 | Avvia disattivato, necessario per un autoplay affidabile |
| start | secondi | Punto di inizio della riproduzione |
| end | secondi | Punto di fine della riproduzione |
| loop | 0 / 1 | Ripete il video (richiede il parametro playlist per un singolo video) |
| controls | 0 / 1 | Mostra o nasconde la barra dei comandi |
| rel | 0 / 1 | Limita i suggerimenti di fine video allo stesso canale |
| list | ID playlist | Carica una playlist completa tramite /embed/videoseries |
| index | numero | Quale elemento della playlist avviare |
| hl | codice lingua | Lingua dell’interfaccia del player |
| cc_load_policy | 0 / 1 | Forza i sottotitoli attivi di default |
| color | red / white | Colore della barra di avanzamento |
Letture correlate
Per l’aspetto del layout dell’embed, vedi la nostra guida sugli embed YouTube responsive. Per la privacy, vedi incorporare video YouTube senza cookie. Per la risoluzione dei problemi, vedi video YouTube che non si incorpora: 8 soluzioni.
Parametri spesso confusi tra loro
Alcuni di questi dodici parametri vengono confusi abbastanza spesso da meritare un confronto diretto. autoplay e loop suonano simili ma svolgono compiti diversi: autoplay controlla se la riproduzione inizia al caricamento, loop controlla se ricomincia dopo la fine, e sono comunemente usati insieme ma sono impostazioni indipendenti. start e index sono anch’essi facili da confondere: start è uno scarto temporale in secondi all’interno di un singolo video, mentre index è una posizione all’interno di una playlist, contata in elementi anziché in tempo. Abbinarli correttamente è importante, perché scambiarli (per esempio, cercare di usare index su un embed a video singolo) semplicemente non produce alcun effetto invece di generare un errore.
Parametri con supporto limitato o incoerente
Non tutti i parametri si comportano in modo identico in ogni contesto. modestbranding, che riduce la presenza del logo di YouTube, ha avuto effetti incoerenti tra le diverse versioni del player ed è generalmente considerato un’impostazione a livello di miglior sforzo piuttosto che garantita. Allo stesso modo, alcuni parametri legati alla visualizzazione possono comportarsi leggermente diversamente a seconda che un visitatore sia connesso a un account Google nel proprio browser, poiché le preferenze a livello di account possono interagire con le impostazioni predefinite del player. I parametri di controllo della riproduzione trattati sopra, start, end, autoplay, mute, loop e controls, sono i più affidabili in modo costante tra browser e stati dell’account, motivo per cui sono quelli su cui vale la pena costruire la propria strategia di embed.
Un esempio pratico: costruire passo dopo passo l’embed di una pagina di corso
Immagina di dover incorporare un video di lezione su una pagina di corso e di volerlo rispettoso della privacy, responsive, con inizio al minuto due, dove comincia davvero il contenuto della lezione (saltando un’introduzione del canale), con sottotitoli attivi di default per accessibilità, e senza autoplay poiché il visitatore dovrebbe scegliere lui stesso di avviarlo. Esaminando i parametri: rispettoso della privacy significa il dominio youtube-nocookie.com; responsive significa un contenitore basato su percentuali invece di dimensioni fisse; iniziare al minuto due significa start=120; sottotitoli di default significa cc_load_policy=1; e nessun autoplay significa semplicemente omettere il parametro autoplay, poiché è lo stato predefinito. L’URL di embed risultante sarebbe:
https://www.youtube-nocookie.com/embed/ID_VIDEO?start=120&cc_load_policy=1&rel=0Questo singolo esempio mostra come i parametri trattati in questa guida si combinino naturalmente per risolvere un requisito specifico e realistico, invece di esistere come un elenco astratto.
Testare le tue combinazioni di parametri
Prima di pubblicare un embed con diversi parametri combinati, vale la pena testarlo direttamente invece di dare per scontato che la combinazione funzioni come previsto. Incolla l’URL di embed completo, parametri inclusi, direttamente in una scheda del browser; il player dovrebbe comportarsi esattamente come farebbe dentro l’iframe della tua pagina, il che ti permette di individuare errori di battitura nei nomi dei parametri (un errore comune, dato che un parametro scritto male viene di solito semplicemente ignorato in silenzio invece di essere segnalato come errore) prima che raggiungano il tuo sito attivo.
Parametri e privacy: quali interagiscono con il dominio nocookie
Vale la pena chiarire che ogni parametro trattato in questa guida funziona in modo identico sia che tu usi il dominio standard di embed youtube.com sia il dominio youtube-nocookie.com, migliorato dal punto di vista della privacy. La scelta del dominio e i parametri di riproduzione sono decisioni del tutto indipendenti: passare al dominio migliorato dal punto di vista della privacy non disabilita né altera nessuno tra autoplay, mute, start, end, loop, controls, rel, list, index, hl, cc_load_policy o color. Questo è un punto di confusione comune che vale la pena affrontare direttamente, dato che alcuni gestori di siti presumono che la modalità privacy sia una versione ridotta del player con meno opzioni, mentre in pratica è funzionalmente identica, solo con un comportamento diverso dei cookie lato Google.
Costruire il proprio riferimento di parametri per un progetto specifico
Per un sito più grande con molti video incorporati, vale la pena documentare internamente quale combinazione di questi dodici parametri il tuo team usa come predefinita, invece di reinventare la scelta per ogni nuovo embed. Uno standard interno semplice, per esempio: usa sempre il dominio migliorato dal punto di vista della privacy, includi sempre rel=0, non usare autoplay di default a meno che un tipo di pagina specifico non lo richieda, e usa sempre un contenitore responsive, mantiene coerenti gli embed su tutto il sito e rende molto più veloce individuare un embed configurato male durante una revisione. Trattare questo elenco di dodici parametri come un menu da cui scegliere le impostazioni predefinite, invece che una decisione presa da zero ogni volta, ripaga man mano che i contenuti video di un sito crescono.
Una considerazione finale su come tenere a portata questo riferimento
Salvare questa pagina, o la tabella di riferimento sopra in particolare, tra i preferiti è probabilmente più utile che cercare di memorizzare tutti e dodici i parametri a memoria. In pratica, la maggior parte degli embed su un sito tipico usa solo tre o quattro di questi contemporaneamente (comunemente un dominio migliorato dal punto di vista della privacy in modo implicito, rel=0, e occasionalmente start o autoplay/mute insieme), quindi avere l’elenco completo da controllare per i casi meno comuni, come playlist o sottotitoli, copre le situazioni rimanenti senza bisogno di memorizzare tutto in anticipo.
Come si confronta questa guida con la documentazione ufficiale di YouTube
YouTube pubblica la propria documentazione per sviluppatori che copre l’IFrame Player API e i parametri di embed, rivolta principalmente agli sviluppatori che costruiscono player personalizzati controllati via JavaScript, piuttosto che ai gestori di siti che aggiungono un semplice embed a una pagina. Questa guida si concentra specificamente sul sottoinsieme di parametri rilevanti per un normale embed iframe senza JavaScript personalizzato, che copre la grande maggioranza dei casi d’uso reali su siti web ordinari. Per chi costruisce esperienze video più avanzate e controllate a livello di programmazione (pulsanti play personalizzati, tracciamento dell’avanzamento della visione, player multi-video sincronizzati), la documentazione ufficiale dell’IFrame Player API di YouTube è il passo successivo oltre a ciò che un approccio basato su parametri di query string come questo può offrire.
Un riepilogo finale dei dodici parametri
Tra autoplay, mute, start, end, loop, controls, rel, list, index, hl, cc_load_policy e color, la conclusione pratica è che un piccolo gruppo (scelta del dominio privacy, rel e un contenitore responsive) costituisce un’impostazione predefinita sensata per quasi ogni embed, mentre il resto (start/end, loop, formattazione Shorts, playlist, sottotitoli, lingua e colore) sono strumenti situazionali da usare solo quando una pagina specifica lo richiede davvero, invece di essere aggiunti indiscriminatamente a ogni embed di un sito.
Creane uno adesso
Strumento gratuito
Salta le query string manuali. Incolla un link e attiva le opzioni che ti servono.
Tenere questo riferimento a portata di mano significa non dover mai indovinare a memoria i nomi dei parametri quando emerge una nuova esigenza di embed.
Domande frequenti
Tutti questi parametri funzionano insieme senza conflitti?
Sì, possono generalmente essere combinati liberamente. La principale dipendenza da ricordare è che loop richiede un parametro playlist corrispondente per funzionare su un singolo video.
Ci sono parametri che non funzionano più?
Alcuni parametri più vecchi citati in vecchi tutorial, come showinfo, sono stati deprecati da YouTube nel tempo e non hanno più alcun effetto visibile.
Devo memorizzarli per usarli?
No. Il nostro generatore di codice embed gratuito espone i più utili come semplici interruttori e campi e costruisce l’URL per te.
Cosa succede se scrivo male il nome di un parametro?
Il player di YouTube generalmente ignora i parametri che non riconosce invece di generare un errore visibile, quindi un errore di battitura non ha effetto silenziosamente, motivo per cui testare l’esatto URL di embed è utile.
Posso impostare un livello di volume predefinito con un parametro?
No, non esiste un parametro per un livello di volume predefinito specifico; il player parte disattivato (tramite il parametro mute) oppure all’ultima impostazione di volume usata dallo spettatore.
Questi parametri funzionano allo stesso modo su mobile?
In generale sì, anche se i browser mobile applicano proprie restrizioni aggiuntive sull’autoplay oltre a quelle di YouTube, quindi l’autoplay silenzioso è ancora più costantemente necessario su mobile rispetto al desktop.
Posso modificare questi parametri dopo che un video è già incorporato nella mia pagina?
Sì, dato che i parametri risiedono semplicemente nell’URL src dell’iframe, modificare l’HTML della tua pagina e ripubblicarla ha effetto immediato per chiunque carichi la pagina successivamente.
C’è un numero massimo di parametri che posso combinare?
Nessun limite pratico; gli URL possono contenere molti parametri, e tutti e dodici trattati qui possono tecnicamente essere combinati su un singolo embed contemporaneamente, anche se non tutte le combinazioni hanno senso insieme.