5000 octets, pas des caractères : la limite de caractères de la description YouTube

Quelle est la limite de caractères de la description YouTube ?

La YouTube Data API de Google fixe la limite de caractères de la description YouTube à 5000 octets, et non à 5000 caractères, et dans le même objet plafonne le titre de la vidéo à 100 caractères et la liste complète des tags à 500 caractères. La page de référence de la ressource videos le dit sans détour : « The video's description. The property value has a maximum length of 5000 bytes and may contain all valid UTF-8 characters except < and >. » Deux champs sur un même objet, deux unités différentes.

Ce seul mot change la réponse pour quiconque écrit dans un alphabet non latin ou utilise des emojis. Un octet mesure du stockage, un caractère mesure du texte. UTF-8 encode une lettre ASCII sur un octet et un caractère japonais sur trois, donc les deux nombres divergent dès que votre description cesse d'être de l'anglais simple.

Champ	Limite documentée	Unité	Propriété de l'API
Titre de la vidéo	100	caractères	snippet.title
Description de la vidéo	5000	octets	snippet.description
Tous les tags réunis	500	caractères	snippet.tags[]

Source : la référence de la YouTube Data API v3 pour la ressource videos, consultée le 10 septembre 2026.

Pourquoi YouTube compte-t-il la description en octets ?

YouTube compte la description en octets parce que le champ est validé par rapport à son encodage UTF-8 stocké, et non par rapport à un nombre de caractères affichés. UTF-8 est à largeur variable : il consacre un octet à la plage ASCII d'origine, deux au latin accentué, au cyrillique, au grec, à l'hébreu et à l'arabe, trois au chinois, au japonais, au coréen et au devanagari, et quatre aux plans des emojis. L'API mesure la taille de la chaîne encodée. Votre éditeur de texte mesure autre chose.

C'est le même piège que l'AT Protocol documente pour les offsets byteStart et byteEnd des facets Bluesky, et le même dans lequel tombe Meta quand Threads compte un emoji selon sa longueur en octets UTF-8. Comptez les octets encodés avant d'envoyer, pas les caractères qu'affiche votre éditeur.

Combien de caractères obtenez-vous réellement dans une description ?

Vous n'obtenez 5000 caractères que si chaque caractère de la description est en ASCII. Divisez le budget de 5000 octets par le coût par caractère de votre écriture pour obtenir le vrai plafond.

bytes = (1 x ascii_chars) + (2 x two_byte_chars) + (3 x three_byte_chars) + (4 x four_byte_chars)

Contenu	Exemple	Octets par caractère	Caractères dans 5000 octets
Lettres ASCII, chiffres, espaces, ponctuation	a	1	5000
Latin accentué, cyrillique, grec, arabe, hébreu	д	2	2500
Chinois, japonais, coréen, devanagari	動	3	1666
Emojis des plans supplémentaires	🔥	4	1250

Les emojis composés coûtent plus d'un point de code. Un pouce levé avec un modificateur de teinte de peau représente deux points de code de quatre octets chacun, donc 👍🏽 coûte 8 octets. Un emoji famille de quatre personnes se compose de quatre emojis reliés par trois zero width joiners (le caractère invisible qui soude les emojis entre eux), et chaque joiner est un caractère de trois octets, donc 👨‍👩‍👧‍👦 coûte 25 octets pour un seul glyphe que le lecteur voit comme une seule image.

Une description de moins de 5000 caractères peut-elle quand même être refusée ?

Oui, et voici le calcul. Prenez une chaîne de cuisine japonaise dont la description contient 1 200 caractères japonais de notes de recette, 1 100 caractères ASCII d'horodatages et d'URL, et 40 emojis.

(1200 x 3) + (1100 x 1) + (40 x 4) = 3600 + 1100 + 160 = 4860 bytes

Cette description fait 2 340 caractères et 4 860 octets, donc elle passe. Ajoutez 47 caractères japonais et elle passe à 2 387 caractères et 5 001 octets, un octet au-dessus du plafond. L'API refuse une description de 2 387 caractères, moins de la moitié du nombre qu'on avait donné comme objectif au créateur. Le refus arrive sous la forme invalidDescription avec un HTTP 400 et le message « The request metadata specifies an invalid video description », qui ne mentionne ni longueur ni unité.

Une description, un octet de trop

2 340 caractères, 4 860 octets

• 1 200 caractères japonais
• 1 100 caractères ASCII
• 40 emojis
• Se télécharge sans problème

2 387 caractères, 5 001 octets

• 47 caractères japonais de plus
• Un octet au-dessus de la limite de 5000 octets
• Refusée avec invalidDescription, HTTP 400

Le Centre d'aide de YouTube est-il d'accord avec l'API ?

Non. L'article du Centre d'aide de YouTube sur l'importation de vidéos indique « Video descriptions have a character limit of 5,000 characters and cannot include invalid characters », ce qui emploie la mauvaise unité pour le champ même que l'API documente en octets. Le chiffre du titre concorde sur les deux pages à 100 caractères, le désaccord se limite donc à la description.

Considérez la référence de l'API comme l'autorité, car elle décrit le validateur qui accepte ou refuse votre import. En alphabet latin sans emojis, les deux documents donnent la même réponse pratique et l'écart ne se voit jamais. En japonais, en hindi, en arabe ou en russe, le chiffre du Centre d'aide surestime votre budget d'un facteur deux à trois.

Où YouTube tronque-t-il la description sur la page de lecture ?

YouTube ne publie pas le point auquel la page de lecture tronque une description. Le chiffre de 5000 octets est une limite de stockage appliquée à l'import, et l'aperçu replié au-dessus du bouton « ...more » est un comportement de mise en page distinct que YouTube ne documente nulle part. Ni la référence de la Data API ni l'article du Centre d'aide sur l'ajout d'une description n'indiquent de nombre de caractères, d'octets ou de lignes pour la vue repliée.

Le mécanisme explique pourquoi aucun nombre fixe n'existe. La page de lecture affiche la description dans un conteneur dont la hauteur dépend de la mise en page environnante, et la quantité de texte visible avant que le lecteur ne la déplie varie avec la largeur du viewport, la taille de police et les lignes de métadonnées situées au-dessus. Un nombre valable sur un écran de bureau de 27 pouces ne l'est pas sur un téléphone en mode portrait. Des chiffres circulent dans les articles SEO comme si Google les avait publiés. Google ne l'a pas fait.

La solution ne dépend pas du point de coupe : placez le lien, l'appel à l'action et la phrase qui doit être lue dans les premières lignes, puis laissez le reste s'allonger. La mise en forme de ce bloc d'ouverture compte aussi, et les règles de mise en forme du texte sur YouTube déterminent ce qui s'affiche et ce qui apparaît en caractères littéraux.

Qu'est-ce qui compte dans la limite de 500 caractères des tags ?

La limite de 500 caractères s'applique à la liste de tags dans son ensemble, pas à chaque tag. L'API la documente sur la propriété de type tableau : « A list of keyword tags associated with the video. Tags may contain spaces. The property value has a maximum length of 500 characters. » Vingt tags de 25 caractères en moyenne épuisent le budget, et une seule expression longue traîne de 60 caractères en prend à elle seule un huitième.

YouTube ne documente pas si les séparateurs entre les tags comptent dans les 500, donc l'hypothèse sûre est qu'ils comptent et la cible sûre se situe quelques caractères sous le plafond. Notez encore l'unité : les tags se comptent en caractères alors que la description d'à côté se compte en octets, donc un jeu de tags non latins se comporte autrement qu'une description non latine. D'autres réseaux définissent leurs limites encore autrement, de la limite des légendes TikTok mesurée en runes UTF-16 à la limite de caractères du texte alternatif dans l'API Instagram.

Où se place adaptlypost

adaptlypost publie sur YouTube via la même Data API à laquelle appartiennent ces limites, donc le plafond de 5000 octets s'y applique exactement comme à un import direct. Le planificateur de vidéos YouTube met en file d'attente les imports avec leurs titres, descriptions et tags, et le rédacteur de légendes IA rédige le texte de description que vous vérifiez ensuite par rapport au budget d'octets. Aucun outil de planification ne relève le plafond d'une plateforme ; les limites ci-dessus sont celles de Google et elles valent quel que soit le client qui envoie la requête.

Questions fréquentes

La limite de caractères de la description YouTube est-elle de 5000 caractères ou de 5000 octets ?

La YouTube Data API la documente à 5000 octets sur la propriété snippet.description de la ressource videos. Le Centre d'aide de YouTube indique 5 000 caractères pour le même champ. La référence de l'API est celle qui correspond au validateur, donc traitez la limite comme 5000 octets.

Combien de caractères japonais ou chinois tiennent dans une description YouTube ?

UTF-8 encode la plupart des caractères chinois, japonais et coréens sur trois octets, ce qui place le plafond à 1 666 caractères de texte CJK pur. Un contenu mixte se situe entre ce chiffre et 5 000 selon la part d'ASCII qu'il contient. Les horodatages, les URL et les hashtags latins coûtent un octet par caractère et étirent le budget.

Un emoji compte-t-il pour un caractère dans une description YouTube ?

Non. Les emojis des plans supplémentaires coûtent quatre octets chacun, un modificateur de teinte de peau en ajoute quatre autres, et chaque zero width joiner d'un emoji composé en ajoute trois. Un emoji famille de quatre personnes coûte 25 octets sur le budget de 5000 octets tout en occupant un seul glyphe à l'écran.

Quelle est la limite de caractères du titre d'une vidéo YouTube ?

L'API plafonne snippet.title à 100 caractères et exprime cette limite en caractères, pas en octets. La même propriété interdit les caractères < et >. Le Centre d'aide de YouTube donne le même chiffre de 100, donc ce champ ne présente aucun désaccord d'unité.

Combien de tags une vidéo YouTube peut-elle avoir ?

YouTube plafonne la longueur totale de la liste de tags à 500 caractères et ne documente aucune limite sur le nombre de tags. Vingt tags de 25 caractères remplissent le budget, tout comme quarante tags de 12 caractères. YouTube ne documente pas si les séparateurs comptent dans les 500.

Où YouTube coupe-t-il la description avant « ...more » ?

YouTube ne publie aucun point de troncature. La hauteur repliée résulte de la mise en page et varie avec la largeur du viewport, la taille de police et les lignes de métadonnées au-dessus de la description, donc la partie visible diffère entre un navigateur de bureau et un téléphone. Écrivez d'abord les lignes importantes au lieu de viser un nombre de caractères que personne chez Google n'a confirmé.

Quel message d'erreur apparaît quand une description YouTube dépasse la limite d'octets ?

L'API refuse l'envoi avec l'erreur invalidDescription et un statut HTTP 400. Le message indique "The request metadata specifies an invalid video description" et ne précise ni la longueur ni l'unité en cause. Comprendre ce refus suppose de déjà savoir que ce champ se mesure en octets.

Les séparateurs entre les tags YouTube comptent-ils dans la limite de 500 caractères ?

YouTube ne précise pas si les virgules ou les espaces entre les tags de snippet.tags[] comptent dans la limite de 500 caractères. L'hypothèse prudente est que oui, donc mieux vaut viser quelques caractères sous le plafond plutôt que pile dessus. Vingt tags de 25 caractères en moyenne épuisent déjà le budget sans compter aucun séparateur.

Le rédacteur de légendes IA d'adaptlypost vérifie-t-il automatiquement la limite d'octets d'une description ?

Non. adaptlypost limite une description YouTube à 5000 caractères dans l'éditeur, mais la YouTube Data API applique son plafond en octets, donc un brouillon du rédacteur de légendes IA peut respecter la limite de caractères et être quand même refusé. Un texte avec des accents, en cyrillique ou en écriture CJK épuise les octets avant les caractères. Comptez les octets avant de planifier une longue description qui n'est pas en anglais, car aucun outil de planification ne relève le plafond fixé par Google.

Combien de caractères tiennent dans une description YouTube écrite en arabe, en hébreu ou en russe ?

Ces alphabets se trouvent dans la plage deux octets d'UTF-8, avec le latin accentué et le grec, ce qui fixe le plafond pratique à 2500 caractères au lieu de 5000. C'est la moitié du budget que laisse penser le chiffre du Centre d'aide. Mélanger du texte ASCII comme des URL ou des horodatages étire à nouveau le total, puisque chacun de ces caractères coûte un octet au lieu de deux.