Alt text

What is alt text? It is a short written description of an image. Screen readers read it aloud, and browsers show it when the image fails to load. On social posts, good alt text says what the image shows and why it matters to the post, in a sentence or two.

Alt text

Alt text is a short written description of an image that screen readers read aloud and that shows when an image does not load.

Example

Example: for a photo of a latte on a wooden table, write "Oat latte with leaf-shaped foam on a wooden cafe table."

Related documents

Related terms

In Weekbird

Weekbird puts the week's posts on one calendar, so you can write image descriptions in the same sitting as the captions before anything goes out.

What is alt text

Alt text, short for alternative text, gives people who cannot see an image the same information the image gives everyone else. W3C's guidance asks you to describe what the image conveys in context. When an image only decorates, W3C says to leave the alt text empty so screen readers skip it.

Examples: before and after

Write for the post the image sits in. The same photo can need different alt text on a menu post and on a hiring post.

ImageWeakBetter
Product photoCoffeeOat latte with leaf-shaped foam on a wooden cafe table.
ChartChart of salesBar chart: weekend orders doubled from 40 in June to 80 in September.
Decorative dividerBlue lineEmpty alt text, so screen readers skip it.

Where networks accept alt text

Limits come from each network's developer documentation. Where a network sets no limit, keep the description short anyway: a listener hears every word.

NetworkAlt text limitNote
Instagram1,000 charactersImages only, not Reels or Stories
LinkedIn4,086 charactersLinkedIn recommends under 120
Pinterest500 charactersPer Pin
BlueskyNo length limit in the protocolPer image, up to 4 images

Checklist

  • Say what the image shows that the caption does not.
  • Put text that appears in the image into the alt text.
  • Skip "image of" and "photo of".
  • Leave decorative images empty where the network allows it.
  • Carousel post: each slide needs its own description.
  • Hashtag: keep it in the caption, out of alt text.
  • Social media audit: a good moment to check old posts for missing alt text.

Use it in your week

Write the descriptions in the same sitting as the captions, while you still have the images open. The alt text generator gives you a first draft to edit.

Frequently asked questions

Questions

Plan the week's posts, images and descriptions together