How to add alt text to your social media images, network by network
Alt text is the sentence a screen reader reads aloud in place of your picture. Most posts go out without one, not out of indifference but because every app hides the field somewhere different. This is how to write it once, and where it goes from there.
Rodolfo MotaFounder of SPREVA
The short version
Write one or two sentences about what the picture shows and why it is in the post. In SPREVA you write it once, on the picture in your library, and it goes with that picture to X, Bluesky, Mastodon, LinkedIn, Tumblr and the other networks that take it, whenever you post it. Pinterest and Lemmy have a field of their own in the post. Instagram, Facebook, Threads and TikTok do not receive it from SPREVA yet.
How to write good alt text
Good alt text is short, specific and written for the post it is in:
- Say what matters in the picture, in the order you would notice it.
- Keep it to one or two sentences: a long description tires the listener.
- If the picture contains words that matter, a price or a date, include them word for word.
- Leave out “image of” or “photo of”: the screen reader already says it is an image.
- Describe it for this post: the croissant in a post about croissants, the shop window in a post about opening hours.
“Croissant” is not alt text. “A golden croissant on a blue plate, cut open to show its layers” is.
Write it once, in your library
- 1
Open the picture in your media library and write in Alt text. It saves as you type.
- 2
Or, in a post, press ALT on the picture: the same field, saved with the picture and used wherever you post it.
- 3
Stuck for words? Suggest alt text writes one from the picture, in your workspace's language, for 1 AI credit. It is added at once, so read it, and Undo if it misses.
- 4
Pictures with alt text carry an ALT badge in the library, so the ones still missing it stand out.
Alt text is not the description SPREVA writes about every upload. That description is for finding pictures in your library by what they show; alt text is what a screen reader reads, and you write it, or ask for it, separately. How the library describes a picture.
Which networks receive it
When you post a picture that has alt text, SPREVA sends it to every network that takes it, within that network's limit:
| Network | Alt text from SPREVA | Limit |
|---|---|---|
| X | Yes, on images | 1,000 characters |
| Bluesky | Yes, on images and video | 2,000 characters |
| Mastodon | Yes, on images and video | Your server's; 1,500 on a standard one |
| Yes, on images | 4,086 characters | |
| Tumblr | Yes, on images | 4,096 characters |
| From its own Alt text field in the post | 500 characters | |
| Lemmy | From its own Alt text field in the post | 1,000 characters |
| WordPress, Slack, Discord, Nostr | Yes | Up to 1,000 characters |
| Instagram, Facebook, Threads, TikTok | Not yet | Added in their apps |
Mastodon, where image descriptions are part of the culture, is also the one network where SPREVA warns you before publishing a post whose pictures have none.
Where you still add it by hand
Instagram, Facebook, Threads and TikTok do not receive alt text from SPREVA yet. On Instagram and Facebook you can add it by editing the post in their app once it is out. Keep the sentence you wrote in the library: it is ready to paste.
With an AI agent
An AI agent connected to SPREVA can fill in the gaps in your library for you:
Find the photos I uploaded this week that have no alt text and add one to each: one or two sentences, what the picture shows and anything written in it.
Start with this week's pictures
Open the library, look for the pictures without an ALT badge, and give each a sentence before they go out. Every plan starts with a 7-day trial with 300 AI credits.
Questions
What is alt text?
A short written description of a picture, read aloud by screen readers and shown when the picture cannot load.
How long should alt text be?
One or two sentences. Networks allow more, from 500 characters on Pinterest to over 4,000 on LinkedIn, but a listener wants the point, not an inventory.
Does SPREVA send alt text to Instagram?
Not yet. Add it by editing the post in Instagram once it is published.
Is the library's description the same as alt text?
No. The description is what SPREVA writes about every upload so you can search the library by what it shows. Alt text is what a screen reader reads, and you write it, or ask for a suggestion, separately.
Can a video have alt text?
Yes. Bluesky, Mastodon, Discord, Slack and Nostr receive it; X and Tumblr take alt text on images only.
Written by
Rodolfo Mota
Founder of SPREVA
Makes SPREVA in Portugal: the Studio, the tools an agent works with, and the publishing behind them.
Keep reading
- A media library that knows what is in itFolders and file names stop working at about a hundred files. What SPREVA does instead: every upload described and tagged as it arrives, videos transcribed, alt text suggested, and a search that understands “the window at dusk”.
- Character limits for every social network in 2026Instagram 2,200, LinkedIn 3,000, X 280, Threads 500, Bluesky 300: the text limit of every network SPREVA publishes to, in two tables, and how each one counts.
- How to post to Instagram from your computer, and schedule itYes, you can post to Instagram from a computer: feed posts, carousels, Reels and Stories, scheduled ahead. How it works in SPREVA, and what it checks first.