Los parámetros de incrustación de YouTube son las opciones de la cadena de consulta que controlan exactamente el aspecto y el comportamiento de un video incrustado. Esta guía repasa uno a uno doce de los más útiles, con un ejemplo funcional para cada uno, para que veas con precisión qué cambia cada parámetro.
Cómo se añaden los parámetros a una URL de incrustación
Cada parámetro se añade a la URL de incrustación como un par clave-valor, unido con un signo &: https://www.youtube-nocookie.com/embed/ID_DEL_VIDEO?param1=value1¶m2=value2. Puedes combinar tantos como quieras. Los parámetros de tipo booleano suelen usar 1 para “activado” y 0 para “desactivado”, y si omites un parámetro por completo, se aplica el comportamiento por defecto propio de YouTube.
1. autoplay
Inicia el video en el momento en que carga el reproductor, sin que el visitante pulse reproducir.
https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1La mayoría de los navegadores bloquean la reproducción automática de video con sonido a menos que el visitante ya haya interactuado con tu sitio, así que autoplay casi siempre se combina con mute.
2. mute
Inicia el reproductor silenciado, lo que es precisamente lo que hace que autoplay funcione de forma fiable en todos los navegadores.
https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1&mute=13. start
Comienza la reproducción en un número concreto de segundos dentro del video, en lugar de desde el principio.
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=90Noventa segundos en este ejemplo significa que el reproductor se abre directamente en el minuto 1:30.
4. end
Detiene la reproducción en un número concreto de segundos, útil para mostrar solo un fragmento relevante de un video más largo.
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=30&end=90Combinado con start, esto reproduce solo la ventana de 30 a 90 segundos y luego se detiene.
5. loop
Repite el video automáticamente en cuanto termina. Para un único video (no una lista de reproducción), también necesitas añadir un parámetro playlist con el mismo ID de video, o la repetición no funcionará de forma silenciosa.
https://www.youtube-nocookie.com/embed/VIDEO_ID?loop=1&playlist=VIDEO_ID6. controls
Muestra u oculta la barra de controles del reproductor (reproducir/pausar, volumen, progreso, pantalla completa).
https://www.youtube-nocookie.com/embed/VIDEO_ID?controls=0Poner esto en 0 es habitual para video de tipo fondo, donde no quieres controles de reproducción visibles.
7. rel
Controla qué videos relacionados se sugieren al terminar la reproducción. Poner este valor en 0 limita las sugerencias a videos del mismo canal en lugar del grupo más amplio de recomendaciones de YouTube.
https://www.youtube-nocookie.com/embed/VIDEO_ID?rel=08. list (y la ruta videoseries)
Carga una lista de reproducción completa en lugar de un solo video. Esto se combina con la ruta /embed/videoseries en lugar de un ID de video individual.
https://www.youtube-nocookie.com/embed/videoseries?list=PLAYLIST_ID9. index
Se usa junto con una lista de reproducción para elegir en qué elemento empezar, contando desde 0 para el primer video.
https://www.youtube-nocookie.com/embed/videoseries?list=PLAYLIST_ID&index=2Este ejemplo empieza en el tercer video de la lista de reproducción.
10. hl
Define el idioma de los propios elementos de la interfaz del reproductor (no el audio ni los subtítulos del video), usando un código de idioma estándar.
https://www.youtube-nocookie.com/embed/VIDEO_ID?hl=de11. cc_load_policy
Fuerza que los subtítulos se muestren por defecto cuando se pone en 1, útil para incrustaciones centradas en accesibilidad o video con reproducción automática silenciada donde los subtítulos aportan el significado.
https://www.youtube-nocookie.com/embed/VIDEO_ID?cc_load_policy=112. color
Define el color de la barra de progreso del reproductor, aceptando red o white como valores.
https://www.youtube-nocookie.com/embed/VIDEO_ID?color=whiteCombinar varios parámetros
Los parámetros se combinan libremente. Un clip de fondo respetuoso con la privacidad, responsive, con reproducción automática, que se repite en silencio y oculta los controles, podría verse así:
https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1&mute=1&controls=0&loop=1&playlist=VIDEO_ID&rel=0Tabla de referencia
| Parámetro | Valores | Qué hace |
|---|---|---|
| autoplay | 0 / 1 | Inicia la reproducción automáticamente |
| mute | 0 / 1 | Inicia silenciado, necesario para un autoplay fiable |
| start | segundos | Punto de inicio de la reproducción |
| end | segundos | Punto de parada de la reproducción |
| loop | 0 / 1 | Repite el video (necesita el parámetro playlist para un solo video) |
| controls | 0 / 1 | Muestra u oculta la barra de controles |
| rel | 0 / 1 | Limita las sugerencias al final del video al mismo canal |
| list | ID de lista de reproducción | Carga una lista de reproducción completa vía /embed/videoseries |
| index | número | En qué elemento de la lista empezar |
| hl | código de idioma | Idioma de la interfaz del reproductor |
| cc_load_policy | 0 / 1 | Fuerza los subtítulos activados por defecto |
| color | red / white | Color de la barra de progreso |
Lecturas relacionadas
Para el aspecto de la maquetación en la incrustación, consulta nuestra guía sobre incrustaciones responsive de YouTube. Para privacidad, consulta cómo incrustar videos de YouTube sin cookies. Para resolución de problemas, consulta el video de YouTube no se incrusta: 8 soluciones.
Parámetros que suelen confundirse entre sí
Algunos de estos doce parámetros se confunden lo bastante a menudo como para merecer una comparación directa. autoplay y loop suenan parecido, pero hacen cosas distintas: autoplay controla si la reproducción empieza al cargar, loop controla si se reinicia al terminar, y aunque suelen usarse juntos, son ajustes independientes. start e index también son fáciles de confundir: start es un desplazamiento de tiempo en segundos dentro de un solo video, mientras que index es una posición dentro de una lista de reproducción, contada en elementos y no en tiempo. Emparejarlos correctamente importa, ya que confundirlos (por ejemplo, intentar usar index en una incrustación de un solo video) simplemente no tiene ningún efecto en lugar de producir un error.
Parámetros con soporte limitado o inconsistente
No todos los parámetros se comportan igual en todos los contextos. modestbranding, que reduce la presencia del logo de YouTube, ha tenido efectos inconsistentes entre distintas versiones del reproductor y en general se considera un ajuste de mejor esfuerzo y no garantizado. Del mismo modo, algunos parámetros relacionados con la visualización pueden comportarse de forma ligeramente distinta según si el visitante tiene la sesión iniciada con una cuenta de Google en su navegador, ya que las preferencias a nivel de cuenta pueden interactuar con los valores por defecto del reproductor. Los parámetros de control de reproducción cubiertos arriba (start, end, autoplay, mute, loop y controls) son los más fiables y consistentes entre navegadores y estados de cuenta, motivo por el cual conviene construir tu estrategia de incrustación alrededor de ellos.
Un ejemplo trabajado: crear una incrustación para una página de curso paso a paso
Imagina que estás incrustando un video de una lección en una página de curso y quieres que sea respetuoso con la privacidad, responsive, que empiece en el minuto dos, donde realmente empieza el contenido de la lección (saltándose una intro del canal), con subtítulos activados por defecto para accesibilidad, y sin reproducción automática, ya que el visitante debería elegir iniciarlo él mismo. Repasando los parámetros: respetuoso con la privacidad significa el dominio youtube-nocookie.com; responsive significa un contenedor basado en porcentaje en lugar de dimensiones fijas; empezar en el minuto dos significa start=120; subtítulos por defecto significa cc_load_policy=1; y sin autoplay significa simplemente omitir el parámetro autoplay, ya que ese es el estado por defecto. La URL de incrustación resultante sería:
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=120&cc_load_policy=1&rel=0Este único ejemplo muestra cómo los parámetros cubiertos en esta guía se combinan de forma natural para resolver un requisito concreto y realista, en lugar de existir como una lista abstracta.
Probar tus combinaciones de parámetros
Antes de publicar una incrustación con varios parámetros combinados, vale la pena probarla directamente en lugar de asumir que la combinación funciona como se espera. Pega la URL de incrustación completa, con todos los parámetros incluidos, directamente en una pestaña del navegador; el reproductor debería comportarse exactamente igual que dentro del iframe de tu página, lo que te permite detectar erratas en los nombres de los parámetros (un error habitual, ya que un parámetro mal escrito normalmente se ignora en silencio en lugar de marcarse como error) antes de que lleguen a tu sitio en producción.
Parámetros y privacidad: cuáles interactúan con el dominio nocookie
Vale la pena aclarar que todos los parámetros cubiertos en esta guía funcionan de forma idéntica tanto si usas el dominio de incrustación estándar youtube.com como el dominio de privacidad mejorada youtube-nocookie.com. La elección del dominio y los parámetros de reproducción son decisiones totalmente independientes: cambiar al dominio de privacidad mejorada no desactiva ni altera ninguno de autoplay, mute, start, end, loop, controls, rel, list, index, hl, cc_load_policy o color. Este es un punto de confusión habitual que merece la pena aclarar directamente, ya que algunos propietarios de sitios asumen que el modo privado es una versión reducida del reproductor con menos opciones, cuando en la práctica es funcionalmente idéntico, solo que con un comportamiento de cookies distinto del lado de Google.
Crear tu propia referencia de parámetros para un proyecto concreto
En un sitio grande con muchos videos incrustados, vale la pena documentar internamente qué combinación de estos doce parámetros usa tu equipo por defecto, en lugar de reinventar la elección en cada nueva incrustación. Un estándar interno sencillo, por ejemplo: usar siempre el dominio de privacidad mejorada, incluir siempre rel=0, no usar autoplay por defecto salvo que un tipo de página concreto lo requiera, y usar siempre un contenedor responsive, mantiene las incrustaciones coherentes en todo el sitio y facilita mucho detectar una mal configurada durante una revisión. Tratar esta lista de doce parámetros como un menú del que elegir valores por defecto, en lugar de una decisión puntual tomada de cero cada vez, se rentabiliza a medida que crece el contenido de video de un sitio.
Una palabra final sobre tener esta referencia a mano
Guardar esta página en favoritos, o específicamente la tabla de referencia de arriba, es probablemente más útil que intentar memorizar los doce parámetros de golpe. En la práctica, la mayoría de las incrustaciones de un sitio típico usan solo tres o cuatro de estos a la vez (habitualmente un dominio de privacidad mejorada de forma implícita, rel=0, y en ocasiones start o autoplay/mute juntos), así que tener la lista completa para consultarla en los casos menos comunes, como listas de reproducción o subtítulos, cubre el resto de situaciones sin necesidad de memorizarlo todo de antemano.
Cómo se compara la documentación oficial de YouTube con esta guía
YouTube publica su propia documentación para desarrolladores sobre la API del reproductor IFrame y los parámetros de incrustación, dirigida principalmente a desarrolladores que crean reproductores personalizados controlados por JavaScript, más que a propietarios de sitios que añaden una incrustación sencilla a una página. Esta guía se centra específicamente en el subconjunto de parámetros relevantes para una incrustación de iframe estándar sin JavaScript personalizado, que cubre la gran mayoría de los casos de uso reales en sitios web comunes. Para quienes construyan experiencias de video más avanzadas y controladas por programación (botones de reproducción personalizados, seguimiento del progreso de visualización, reproductores multivideo sincronizados), la documentación oficial de la API del reproductor IFrame de YouTube es el siguiente paso más allá de lo que puede ofrecer un enfoque basado en parámetros de cadena de consulta como este.
Un resumen final de los doce parámetros
Entre autoplay, mute, start, end, loop, controls, rel, list, index, hl, cc_load_policy y color, la conclusión práctica es que un pequeño grupo (la elección del dominio de privacidad, rel y un contenedor responsive) forma un valor por defecto sensato para casi cualquier incrustación, mientras que el resto (start/end, loop, formato de Shorts, listas de reproducción, subtítulos, idioma y color) son herramientas puntuales que conviene usar solo cuando una página concreta realmente lo requiere, en lugar de añadirlas de forma indiscriminada a cada incrustación de un sitio.
Créala ahora
Herramienta gratuita
Olvídate de las cadenas de consulta manuales. Pega un enlace y activa las opciones que necesites.
Tener esta referencia a mano significa nunca tener que adivinar de memoria el nombre de un parámetro cuando surge una nueva necesidad de incrustación.
Preguntas frecuentes
¿Todos estos parámetros funcionan juntos sin conflictos?
Sí, en general pueden combinarse libremente. La principal dependencia que hay que recordar es que loop necesita un parámetro playlist correspondiente para funcionar en un solo video.
¿Hay parámetros que ya no funcionan?
Algunos parámetros más antiguos, mencionados en tutoriales antiguos, como showinfo, han quedado obsoletos por parte de YouTube con el tiempo y ya no tienen ningún efecto visible.
¿Necesito memorizarlos para usarlos?
No. Nuestro generador de código de incrustación gratuito expone los más útiles como simples interruptores y campos, y construye la URL por ti.
¿Qué ocurre si escribo mal el nombre de un parámetro?
El reproductor de YouTube generalmente ignora los parámetros que no reconoce en lugar de mostrar un error visible, así que una errata simplemente no tiene efecto en silencio, por lo que probar tu URL de incrustación exacta merece la pena.
¿Puedo establecer un nivel de volumen por defecto con un parámetro?
No, no existe un parámetro para un nivel de volumen por defecto concreto; el reproductor empieza silenciado (mediante el parámetro mute) o con el último volumen usado por el espectador.
¿Estos parámetros funcionan igual en móvil?
En general sí, aunque los navegadores móviles aplican sus propias restricciones adicionales de autoplay por encima de las de YouTube, así que el autoplay silenciado es incluso más necesario de forma consistente en móvil que en escritorio.
¿Puedo cambiar estos parámetros después de que un video ya esté incrustado en mi página?
Sí, ya que los parámetros simplemente residen en la URL src del iframe, editar el HTML de tu página y volver a publicarla surte efecto de inmediato para cualquiera que cargue la página después.
¿Hay un número máximo de parámetros que puedo combinar?
Sin límite práctico; las URL pueden llevar muchos parámetros, y los doce cubiertos aquí pueden combinarse técnicamente en una sola incrustación a la vez, aunque no todas las combinaciones tienen sentido juntas.