TL;DR, Réponse Rapide
8 min de lectureMastodon appelle le texte alternatif une « description du média » : un champ en texte brut sur chaque pièce jointe, que les lecteurs d'écran lisent à voix haute et qui s'affiche quand le média ne se charge pas. Dans l'app web, vous le remplissez avec le bouton ALT ou Edit d'un fichier joint. Dans l'API, c'est le paramètre description de POST /api/v2/media. Chaque serveur fixe son propre plafond, publié sous description_limit dans /api/v2/instance : le code de Mastodon fixait 1,500 caractères jusqu'à la version 4.5 et 10,000 à partir de la 4.6. L'app web vous avertit avant de publier un média sans description, et ce réglage est activé par défaut.
Qu'est-ce que le texte alternatif Mastodon ?
Écrire un texte alternatif Mastodon, c'est remplir la description du média que porte chaque pièce jointe d'un post Mastodon, un champ en texte brut que les lecteurs d'écran lisent à la place de l'image, de la vidéo ou de l'audio. Le guide de publication de Mastodon indique que ces descriptions « will be shown when the media fails to load for any reason, or when accessed by screen readers and other assistive technology. »
La description appartient à la pièce jointe, pas au texte du post. Quand vous joignez un fichier, Mastodon l'envoie comme un objet pièce jointe distinct, et la description est stockée sur cet objet à côté de son point focal. Un post contient jusqu'à 4 pièces jointes sur mastodon.social, donc un post avec quatre photos porte quatre descriptions distinctes.
La documentation de l'API définit le champ en une ligne : « A plain-text description of the media, for accessibility purposes. » Texte brut signifie aucun lien, aucune mention et aucune mise en forme dans la description.
Comment ajouter un texte alternatif à une image sur Mastodon ?
Vous ajoutez un texte alternatif dans l'app web Mastodon en cliquant sur le bouton ALT ou Edit d'une image jointe, en tapant la description dans la boîte de dialogue « Add alt text » et en cliquant sur Done avant de publier. Les étapes sur Mastodon 4.7 :
- Ouvrez le composeur et joignez un fichier image, vidéo ou audio.
- Regardez la miniature. Un bouton ALT se trouve dans son coin, et il affiche une icône d'avertissement tant que le fichier n'a pas de description.
- Cliquez sur ALT, ou sur Edit dans le coin supérieur. Les deux ouvrent la même boîte de dialogue.
- Tapez la description dans la zone de texte, qui affiche « Describe this for people with visual impairments » pour les images et « Describe this for people with hearing impairments » pour l'audio et la vidéo.
- Pour une image qui contient du texte, cliquez sur « Add text from image » pour remplir la zone avec le texte que Mastodon lit dans l'image, puis corrigez-le.
- Cliquez sur Done. L'icône d'avertissement disparaît du bouton ALT.
- Recommencez pour chaque pièce jointe, puis cliquez sur Post.
La même boîte de dialogue règle le point focal, l'endroit que Mastodon garde visible quand il recadre la miniature d'aperçu. Les apps Mastodon tierces placent le champ de description à leur façon, mais elles écrivent toutes le même champ description sur la pièce jointe.
Quelle longueur peut avoir le texte alternatif Mastodon ?
Le texte alternatif Mastodon peut atteindre la description_limit de votre serveur, que le code de Mastodon fixait à 1,500 caractères jusqu'à la version 4.5 et à 10,000 caractères à partir de la version 4.6. Chaque serveur fait tourner sa propre version de Mastodon, donc votre limite dépend du serveur depuis lequel vous publiez, pas de Mastodon dans son ensemble.
| Version de Mastodon | Limite de description dans le code | Où la voir |
|---|---|---|
| 4.2 à 4.3 | 1,500 caractères | Non publiée dans l'API |
| 4.4 à 4.5 | 1,500 caractères | description_limit dans /api/v2/instance |
| 4.6 et suivantes | 10,000 caractères | description_limit dans /api/v2/instance |
La limite se trouve dans MediaAttachment::MAX_DESCRIPTION_LENGTH dans le code source de Mastodon, et le serveur refuse une description plus longue venant de ses propres utilisateurs. La documentation de l'entité Instance affiche encore 1,500 dans son exemple de réponse, alors que mastodon.social indiquait 10,000 le 9 octobre 2026, sur une version nightly 4.8. Sur Mastodon 4.6 et suivantes, le compteur de caractères du composeur web va jusqu'à 10,000.
Les descriptions longues sont autorisées, pas exigées. Décrivez ce que montre l'image et le texte qu'elle contient, et arrêtez-vous là. Le texte d'un post a sa propre limite, présentée dans la limite de caractères de Mastodon, et une description ne compte pas dans cette limite.
Comment vérifier la limite de texte alternatif de votre serveur ?
Vous vérifiez la limite de texte alternatif d'un serveur en lisant configuration.media_attachments.description_limit dans sa réponse à GET /api/v2/instance, qui ne demande aucune connexion. La documentation de l'entité Instance décrit le champ comme « The maximum size of a description, in characters, » et indique qu'il a été ajouté dans Mastodon 4.4.0.
Ouvrez https://your.server/api/v2/instance dans un navigateur et cherchez description_limit dans le JSON. Un serveur en 4.3 ou antérieure omet le champ de la réponse, mais applique quand même 1,500 caractères dans son code. Le même bloc liste les limites de taille des images et des vidéos du serveur ainsi que les types de fichiers acceptés, donc une seule requête répond à la fois à « quelle longueur peut avoir ma description » et à « ce fichier passera-t-il ».
Comment envoyer un texte alternatif via l'API Mastodon ?
Vous envoyez un texte alternatif via l'API Mastodon dans le champ de formulaire description de POST /api/v2/media, l'appel qui envoie le fichier avant que vous le joigniez à un post. Voici tous les endroits où le champ apparaît :
| Appel | Ce qu'il fait de la description |
|---|---|
POST /api/v2/media | Définit la description à l'envoi du fichier |
PUT /api/v1/media/:id | La modifie « before it is attached to a status and posted » |
PUT /api/v1/statuses/:id | La modifie après publication, via media_attributes[][], un tableau qui « includes id, description, and focus » |
L'appel d'envoi renvoie une pièce jointe avec un id, et vous passez cet id dans media_ids[] quand vous créez le statut. Les petites images reviennent avec un HTTP 200 et sont prêtes tout de suite. La vidéo, la vidéo de type GIF et l'audio reviennent avec un 202 et terminent leur traitement en arrière-plan, donc un client attend la fin du traitement avant de publier. Si vous programmez via l'API, la règle des 5 minutes de scheduled_at sur Mastodon fixe à quel point un post peut être mis en file près de l'heure actuelle, et le média et sa description sont joints au post programmé de la même façon.
Pourquoi la culture Mastodon attend-elle un texte alternatif ?
La culture Mastodon attend un texte alternatif parce que le logiciel lui-même le demande à chaque étape : le composeur signale les médias sans description, une boîte de dialogue de confirmation interrompt la publication, et les lecteurs voient quelles images ont une description. Ces réglages par défaut façonnent ce que les utilisateurs considèrent comme normal.
AdaptlyPost
Commencez votre essai gratuit de 7 jours
Analyses multiplateforme
Boîte sociale
Assistant IA
Les signaux que rencontre un utilisateur de Mastodon :
- L'avertissement ALT. Une pièce jointe sans description affiche une icône d'avertissement sur son bouton ALT dans le composeur.
- La vérification à la publication. Cliquer sur Post avec un média sans description ouvre « Add alt text? » avec le message « Your post contains media without alt text. Adding descriptions helps make your content accessible to more people. » Vous choisissez « Add alt text » ou « Post anyway ».
- Le réglage par défaut. La vérification dépend de « Warn me before posting media without alt text » sous Preferences, puis Appearance, et elle est activée sur chaque nouveau compte.
- Le badge ALT. Les images décrites affichent un badge ALT dans le fil, et cliquer dessus ouvre la description, donc les lecteurs voient d'un coup d'œil qui s'en est passé.
- La documentation. Le guide de publication qualifie les descriptions de facultatives, mais précise que « it is a good idea to add media descriptions that briefly describe what is in contained in the media. »
Le résultat est un réseau où une photo sans description se remarque. Pour qui arrive de réseaux qui cachent le champ alt plus loin, cet écart est le principal ajustement, et la comparaison Mastodon vs Bluesky couvre les autres différences. Les habitudes plus larges, décrire les images, sous-titrer les vidéos et garder un contraste lisible, valent sur tous les réseaux, et l'accessibilité sur les réseaux sociaux les passe en revue.
Comment ajouter un texte alternatif Mastodon aux posts programmés ?
Un outil de programmation ajoute le texte alternatif Mastodon en envoyant chaque image à votre serveur avec votre description dans le champ description, puis en joignant ces envois au post au moment de la publication. AdaptlyPost le fait avec un bouton « Add alt text » sur chaque image du composeur, et une boîte de dialogue qui vous demande de « Describe the image for people who use screen readers. »
Le planificateur de posts Mastodon publie sur n'importe quel serveur Mastodon : vous tapez l'adresse de votre serveur, par exemple mastodon.social, et vous vous y connectez. Chaque post accepte jusqu'à 4 images, chacune avec son propre texte alternatif, et pour un post vidéo, AdaptlyPost attend que votre serveur ait fini de traiter le fichier avant de publier. Le composeur et l'API AdaptlyPost acceptent jusqu'à 1,000 caractères par description, ce qui tient sous chaque limite du tableau ci-dessus. La note du composeur sur le champ de texte alternatif indique « Sent to X, Bluesky, Mastodon, LinkedIn, Facebook, Instagram and Threads, » donc une description par image part vers chaque réseau du post qui en accepte une.
Questions fréquentes
Comment ajouter un texte alternatif sur Mastodon ?
Joignez un fichier dans le composeur, cliquez sur le bouton ALT ou Edit de sa miniature, tapez la description et cliquez sur Done. L'icône d'avertissement du bouton ALT disparaît dès que le fichier a une description. Recommencez pour chaque pièce jointe avant de cliquer sur Post.
Quelle est la limite de caractères du texte alternatif Mastodon ?
La limite est fixée par chaque serveur sous description_limit dans /api/v2/instance. Le code de Mastodon fixait 1,500 caractères jusqu'à la version 4.5 et 10,000 à partir de la version 4.6, donc le chiffre dépend de la version de votre serveur. mastodon.social indiquait 10,000 le 9 octobre 2026.
Le texte alternatif est-il obligatoire sur Mastodon ?
Non. Mastodon accepte les posts sans description de média, et le guide de publication les qualifie de facultatives. L'app web affiche une boîte de dialogue « Add alt text? » avant de publier un média sans description, et cet avertissement est activé par défaut sous Preferences, puis Appearance.
Peut-on modifier le texte alternatif Mastodon après publication ?
Oui, via l'API. PUT /api/v1/statuses/:id accepte media_attributes[][] avec l'id, la description et le point focal de la pièce jointe, donc un client qui gère la modification change la description d'un post publié. Avant publication, PUT /api/v1/media/:id la change sur un envoi pas encore joint.
Que signifie le badge ALT sur les images Mastodon ?
Le badge ALT signifie que l'auteur du post a écrit une description pour cette pièce jointe. Cliquer dessus ouvre le texte de la description. Les images sans description n'affichent aucun badge.
AdaptlyPost envoie-t-il le texte alternatif à Mastodon ?
Oui. AdaptlyPost envoie à votre serveur Mastodon le texte alternatif que vous écrivez pour chaque image, avec l'envoi du fichier, jusqu'à 4 images par post. Chaque description peut atteindre 1,000 caractères dans le composeur et l'API, ce qui tient sous les deux limites de 1,500 et 10,000 du code de Mastodon.
Le texte alternatif compte-t-il dans la limite de caractères de Mastodon ?
La description ne compte pas dans la limite de caractères du post. Le texte du post et chaque description de média ont des limites séparées. Votre serveur fixe la limite des descriptions sous le nom description_limit.
Comment désactiver l'avertissement de texte alternatif de Mastodon ?
Ouvrez Preferences, puis Appearance, et désactivez « Warn me before posting media without alt text ». Ce réglage est activé par défaut sur chaque nouveau compte. Une fois désactivé, Mastodon publie les médias sans description sans afficher le dialogue « Add alt text? ».
Le texte alternatif Mastodon peut-il contenir des liens ou des hashtags ?
Pas sous forme de liens ou de hashtags fonctionnels. L'API définit la description comme « A plain-text description of the media, for accessibility purposes. » Texte brut signifie aucun lien, mention ou mise en forme dans la description.
Comment ajouter un texte alternatif à une vidéo ou un fichier audio sur Mastodon ?
Joignez le fichier, cliquez sur ALT ou Edit sur sa miniature, saisissez la description et cliquez sur Done. Le champ de texte pour l'audio et la vidéo indique « Describe this for people with hearing impairments ». Via l'API, les envois de vidéo et d'audio renvoient 202 et sont traités en arrière-plan, donc un client attend avant de publier.
Mettez cela en pratique avec AdaptlyPost
Cet article vous a-t-il été utile ?
Dites-nous ce que vous en pensez !
Nous voir plus souvent sur Google
Un clic définit AdaptlyPost comme source préférée. Nos articles remontent alors dans vos À la une, en mode IA et dans les aperçus IA.
Avant de partir...
AdaptlyPost
Planifiez vos contenus sur toutes les plateformes
Gérez tous vos comptes de réseaux sociaux en un seul endroit avec AdaptlyPost.
Analyses multiplateforme
Boîte sociale
Assistant IA
Termes connexes du glossaire
Pourquoi la limite de caractères de Mastodon est de 500 sur un serveur et de 11 000 sur un autre
Par défaut, la limite de caractères de Mastodon est de 500 graphèmes, et chaque serveur peut la changer. Une URL compte 23, l'avertissement aussi.
Comment fonctionne le texte alternatif Pinterest sur les Pins et dans l'API
Définir un texte alternatif Pinterest passe par le champ alt_text d'un Pin : 500 caractères, un par Pin, distinct de la description. Rôle et méthode.
Où est vraiment écrite la limite de caractères du texte alternatif LinkedIn
Sur le champ altText de l'API, la limite de caractères du texte alternatif LinkedIn est de 4 086, et aucune limite n'est publiée pour le champ de l'application.
Articles Connexes
Pourquoi le scheduled_at de l'API Mastodon exige 5 minutes d'avance
Le paramètre scheduled_at de l'API Mastodon doit viser plus de 5 minutes à l'avance, sinon le serveur renvoie 422. Une date passée publie aussitôt.
Comment la limite de 500 caractères de l'API Threads traite topic_tag
Meta applique la limite de 500 caractères de l'API Threads au champ text. topic_tag est un paramètre séparé de 50 caractères, et Meta ne dit pas s'il compte.
Comment fonctionne le maximum d'éléments d'un carrousel de l'API Threads
Meta fixe le maximum d'éléments d'un carrousel de l'API Threads à 20 enfants, minimum 2. Voici le flux de conteneurs et ce que renvoie un mauvais appel.