Le lecteur intégré de YouTube accepte une longue liste de paramètres d’URL qui contrôlent presque tout ce qui concerne l’apparence et le comportement d’une vidéo une fois placée sur votre page. Cette référence rassemble ceux qui comptent vraiment, avec des explications simples et des exemples.
Comment fonctionnent les paramètres
Chaque paramètre est ajouté à l’URL d’intégration sous forme de valeur de requête, reliée par une esperluette : https://www.youtube-nocookie.com/embed/VIDEO_ID?param1=valeur¶m2=valeur. Vous pouvez en combiner autant que nécessaire. Les paramètres qui attendent une valeur booléenne 1 ou 0 utilisent 1 pour « activé » et 0 pour « désactivé » ; sauf indication contraire, omettre entièrement un paramètre utilise le comportement par défaut de YouTube.
Paramètres de contrôle de la lecture
| Paramètre | Valeurs | Effet |
|---|---|---|
| autoplay | 0 ou 1 | Démarre la lecture automatiquement. La plupart des navigateurs exigent mute=1 en complément. |
| mute | 0 ou 1 | Démarre le lecteur en muet. Requis par la plupart des navigateurs pour que la lecture automatique fonctionne. |
| start | secondes | Démarre la lecture au nombre de secondes indiqué dans la vidéo. |
| end | secondes | Arrête la lecture au nombre de secondes indiqué. |
| loop | 0 ou 1 | Relit la vidéo en boucle. Pour une seule vidéo, ajoutez aussi playlist=VIDEO_ID (le même ID), sinon la boucle ne fonctionnera pas. |
| controls | 0 ou 1 | Affiche (1, par défaut) ou masque (0) la barre de contrôle du lecteur. |
Paramètres d’affichage et de mise en page
| Paramètre | Valeurs | Effet |
|---|---|---|
| rel | 0 ou 1 | Réglé sur 0, limite les suggestions de vidéos apparentées en fin de lecture à celles de la même chaîne. |
| modestbranding | 0 ou 1 | Réduit la présence du logo YouTube dans les contrôles du lecteur (le support varie selon la version du lecteur). |
| fs | 0 ou 1 | Active (1, par défaut) ou désactive (0) le bouton plein écran. |
| cc_load_policy | 0 ou 1 | Force l’affichage des sous-titres par défaut lorsqu’il est réglé sur 1. |
| hl | code langue | Définit la langue de l’interface du lecteur, par exemple hl=fr. |
| color | red ou white | Définit la couleur de la barre de progression de la vidéo. |
Paramètres de playlist et multi-vidéo
| Paramètre | Valeurs | Effet |
|---|---|---|
| list | ID de playlist | Charge une playlist entière. À combiner avec le chemin /embed/videoseries plutôt qu’un identifiant de vidéo unique. |
| listType | playlist, user_uploads | Change la façon dont le paramètre list est interprété. |
| index | nombre | Élément de la playlist sur lequel démarrer, en comptant à partir de 0. |
Exemples concrets
Respectueux de la vie privée, responsive, démarre à 90 secondes, sans vidéos apparentées :
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=90&rel=0Vidéo d’arrière-plan en lecture automatique muette, contrôles masqués, en boucle :
https://www.youtube-nocookie.com/embed/VIDEO_ID?autoplay=1&mute=1&controls=0&loop=1&playlist=VIDEO_IDExtrait qui ne joue que de 30 à 90 secondes :
https://www.youtube-nocookie.com/embed/VIDEO_ID?start=30&end=90Une playlist entière, en démarrant à la troisième vidéo :
https://www.youtube-nocookie.com/embed/videoseries?list=PLAYLIST_ID&index=2Paramètres qui ne fonctionnent plus
Quelques anciens paramètres, autrefois présents dans les tutoriels d’intégration, comme showinfo et disablekb, ont été supprimés ou dépréciés par YouTube au fil des années. Si un paramètre trouvé dans un ancien article de blog n’a aucun effet visible, c’est généralement la raison : le lecteur de YouTube a évolué et le paramètre est simplement ignoré.
Une remarque sur la fiabilité
Certains paramètres liés à l’affichage, comme modestbranding, sont appliqués au mieux et leur effet visuel exact peut évoluer à mesure que YouTube met à jour son lecteur. Les paramètres de contrôle de la lecture (start, end, autoplay, mute, loop, controls) sont les plus fiables et ceux sur lesquels il vaut la peine de bâtir votre stratégie d’intégration.
Le générer sans rien mémoriser
Vous n’avez pas besoin d’écrire ces chaînes de requête à la main. Notre générateur de code d’intégration gratuit propose les paramètres les plus utiles, temps de début, temps de fin, lecture automatique, muet, boucle, contrôles masqués, mode vie privée, format Shorts et playlists, sous forme de simples cases à cocher et champs, et assemble automatiquement l’URL correcte. Utilisez cette page comme référence lorsque vous voulez comprendre exactement ce que fait un embed généré, ou lorsque vous avez besoin d’un paramètre que le générateur ne propose pas et souhaitez l’ajouter vous-même au code.
Lectures liées
Pour l’aspect mise en page de l’intégration, consultez notre guide sur les embeds YouTube responsives. Pour l’aspect vie privée, consultez intégrer YouTube sans cookies.