El reproductor de embed de YouTube acepta una larga lista de parámetros de URL que controlan casi todo sobre el aspecto y el comportamiento de un vídeo una vez insertado en tu página. Esta referencia recopila los que realmente importan, con explicaciones en lenguaje sencillo y ejemplos.
Cómo funcionan los parámetros
Cada parámetro se añade a la URL del embed como un valor de la cadena de consulta, unido con un ampersand: https://www.youtube-nocookie.com/embed/VIDEO_ID?param1=value¶m2=value. Puedes combinar tantos como necesites. Los parámetros que esperan un valor booleano de 1 o 0 usan 1 para “activado” y 0 para “desactivado”; salvo que se indique lo contrario, si omites un parámetro por completo se aplica el comportamiento predeterminado de YouTube.
Parámetros de control de reproducción
| Parámetro | Valores | Qué hace |
|---|---|---|
| autoplay | 0 o 1 | Inicia la reproducción automáticamente. La mayoría de los navegadores requieren mute=1 junto a él. |
| mute | 0 o 1 | Inicia el reproductor silenciado. Necesario en la mayoría de los navegadores para que funcione el autoplay. |
| start | segundos | Inicia la reproducción en el número de segundos indicado dentro del vídeo. |
| end | segundos | Detiene la reproducción en el número de segundos indicado. |
| loop | 0 o 1 | Repite el vídeo. Para un solo vídeo, añade también playlist=VIDEO_ID (el mismo ID) o el loop no funcionará. |
| controls | 0 o 1 | Muestra (1, predeterminado) u oculta (0) la barra de controles del reproductor. |
Parámetros de visualización y diseño
| Parámetro | Valores | Qué hace |
|---|---|---|
| rel | 0 o 1 | Cuando es 0, las sugerencias de vídeos relacionados al final se limitan al mismo canal. |
| modestbranding | 0 o 1 | Reduce la presencia del logo de YouTube en los controles del reproductor (el soporte varía según la versión del reproductor). |
| fs | 0 o 1 | Activa (1, predeterminado) o desactiva (0) el botón de pantalla completa. |
| cc_load_policy | 0 o 1 | Fuerza a que los subtítulos se muestren de forma predeterminada cuando se establece en 1. |
| hl | código de idioma | Establece el idioma de la interfaz del reproductor, por ejemplo hl=es. |
| color | red o white | Establece el color de la barra de progreso del vídeo. |
Parámetros de listas de reproducción y múltiples vídeos
| Parámetro | Valores | Qué hace |
|---|---|---|
| list | ID de la lista | Carga una lista de reproducción completa. Combínalo con la ruta /embed/videoseries en lugar de un ID de vídeo individual. |
| listType | playlist, user_uploads | Cambia cómo se interpreta el parámetro list. |
| index | número | Qué elemento de la lista de reproducción se inicia primero, contando desde 0. |
Ejemplos prácticos
Respetuoso con la privacidad, responsive, comienza en el segundo 90, sin vídeos relacionados:
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=90&rel=0Vídeo de fondo con autoplay silenciado, controles ocultos, en bucle:
https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1&mute=1&controls=0&loop=1&playlist=VIDEO_IDClip que solo se reproduce entre el segundo 30 y el 90:
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=30&end=90Una lista de reproducción completa, empezando por el tercer vídeo:
https://www.youtube-nocookie.com/embed/videoseries?list=PLAYLIST_ID&index=2Parámetros que ya no funcionan
Algunos parámetros más antiguos que solían aparecer en tutoriales de embed, como showinfo y disablekb, han sido eliminados o descontinuados por YouTube con el paso de los años. Si un parámetro que encuentras en una entrada de blog antigua no tiene ningún efecto visible, esa suele ser la razón: el reproductor de YouTube ha cambiado y el parámetro simplemente se ignora.
Una nota sobre la fiabilidad
Algunos parámetros relacionados con la visualización, como modestbranding, se aplican de forma no garantizada y su efecto visual exacto puede variar según YouTube actualiza su reproductor. Los parámetros de control de reproducción (start, end, autoplay, mute, loop, controls) son los más consistentemente fiables y sobre los que merece la pena construir tu estrategia de embed.
Créalo sin memorizar nada de esto
No necesitas escribir a mano estas cadenas de consulta. Nuestro generador de código de embed gratuito expone los parámetros más útiles (tiempo de inicio, tiempo de fin, autoplay, mute, loop, controles ocultos, modo de privacidad, formato Shorts y listas de reproducción) como simples interruptores y campos, y arma la URL correcta de forma automática. Usa esta página como referencia cuando quieras entender exactamente qué hace un embed generado, o cuando necesites un parámetro que el generador no expone y quieras añadirlo al código a mano.
Lecturas relacionadas
Para el lado del diseño del embed, consulta nuestra guía sobre embeds responsive de YouTube. Para el lado de la privacidad, consulta cómo insertar vídeos de YouTube sin cookies.