Il player embed di YouTube accetta un lungo elenco di parametri nell’URL che controllano quasi ogni aspetto dell’aspetto e del comportamento di un video una volta sulla tua pagina. Questa guida di riferimento raccoglie quelli che contano davvero, con spiegazioni semplici ed esempi pratici.
Come funzionano i parametri
Ogni parametro viene aggiunto all’URL dell’embed come valore della query string, unito con una e commerciale: https://www.youtube-nocookie.com/embed/VIDEO_ID?param1=value¶m2=value. Puoi combinarne quanti ne servono. I parametri che accettano un valore booleano 1 o 0 usano 1 per “attivo” e 0 per “disattivo”; salvo diversa indicazione, omettere un parametro utilizza il comportamento predefinito di YouTube.
Parametri di controllo della riproduzione
| Parametro | Valori | Cosa fa |
|---|---|---|
| autoplay | 0 o 1 | Avvia la riproduzione automaticamente. La maggior parte dei browser richiede anche mute=1. |
| mute | 0 o 1 | Avvia il player disattivando l’audio. Richiesto dalla maggior parte dei browser perché l’autoplay funzioni. |
| start | secondi | Avvia la riproduzione al numero di secondi indicato. |
| end | secondi | Interrompe la riproduzione al numero di secondi indicato. |
| loop | 0 o 1 | Fa ripartire il video. Per un singolo video, aggiungi anche playlist=VIDEO_ID (lo stesso ID), altrimenti il loop non funziona. |
| controls | 0 o 1 | Mostra (1, predefinito) o nasconde (0) la barra dei controlli del player. |
Parametri di visualizzazione e layout
| Parametro | Valori | Cosa fa |
|---|---|---|
| rel | 0 o 1 | Quando è 0, i video correlati mostrati alla fine sono limitati a quelli dello stesso canale. |
| modestbranding | 0 o 1 | Riduce la presenza del logo YouTube nei controlli del player (il supporto varia in base alla versione del player). |
| fs | 0 o 1 | Attiva (1, predefinito) o disattiva (0) il pulsante schermo intero. |
| cc_load_policy | 0 o 1 | Forza la visualizzazione predefinita dei sottotitoli quando impostato su 1. |
| hl | codice lingua | Imposta la lingua dell’interfaccia del player, ad esempio hl=it. |
| color | red o white | Imposta il colore della barra di avanzamento del video. |
Parametri per playlist e video multipli
| Parametro | Valori | Cosa fa |
|---|---|---|
| list | ID playlist | Carica un’intera playlist. Va combinato con il percorso /embed/videoseries invece di un singolo ID video. |
| listType | playlist, user_uploads | Cambia il modo in cui viene interpretato il parametro list. |
| index | numero | Indica da quale elemento della playlist partire, contando da 0. |
Esempi pratici
Rispettoso della privacy, responsive, inizia a 90 secondi, senza video correlati:
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=90&rel=0Video di sottofondo con autoplay silenzioso, controlli nascosti, in loop:
https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1&mute=1&controls=0&loop=1&playlist=VIDEO_IDClip che si riproduce solo dal secondo 30 al secondo 90:
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=30&end=90Un’intera playlist, a partire dal terzo video:
https://www.youtube-nocookie.com/embed/videoseries?list=PLAYLIST_ID&index=2Parametri che non funzionano più
Alcuni parametri più vecchi che comparivano nei tutorial di embed, come showinfo e disablekb, sono stati rimossi o resi obsoleti da YouTube nel corso degli anni. Se un parametro trovato in un vecchio articolo non ha alcun effetto visibile, di solito è per questo motivo: il player di YouTube è cambiato e il parametro viene semplicemente ignorato.
Una nota sull’affidabilità
Alcuni parametri legati alla visualizzazione, come modestbranding, vengono applicati in modo non garantito e il loro effetto visivo esatto può cambiare man mano che YouTube aggiorna il player. I parametri di controllo della riproduzione (start, end, autoplay, mute, loop, controls) sono i più affidabili e quelli su cui vale la pena costruire la propria strategia di embed.
Crealo senza memorizzare nulla di tutto questo
Non è necessario scrivere a mano queste query string. Il nostro generatore gratuito di codice embed espone i parametri più utili, tempo di inizio, tempo di fine, autoplay, mute, loop, controlli nascosti, modalità privacy, formato Shorts e playlist, come semplici interruttori e campi, e costruisce automaticamente l’URL corretto. Usa questa pagina come riferimento quando vuoi capire esattamente cosa fa un embed generato, o quando ti serve un parametro che il generatore non espone e vuoi aggiungerlo al codice a mano.
Letture correlate
Per l’aspetto del layout dell’embed, consulta la nostra guida sugli embed YouTube responsive. Per l’aspetto privacy, consulta come incorporare video YouTube senza cookie.