SEO, SEM, social media, GEO, content & website services · Six focused SEO applications.Help & support ↗
On-page SEO Answer library

How to write alt text for images

Alt text is an accessibility requirement that happens to help image search. Pages that treat it as a keyword field produce noise for screen-reader users and add no ranking value. Pages that write it properly improve both.

Reviewed 3 min read By Aver, founder and SEO lead

The essentials

Describe the content and function, not the file name or the visual style.

  • Decorative images should have empty alt text so screen readers skip them.
  • Text inside an image is invisible to search; put important claims in the copy.

How it works in practice

Treat the list below as the working order for “How to write alt text for images”, not a menu.

  • Look at the image and write one sentence describing what a reader needs to know.
  • Include the subject and, if relevant, the action or context.
  • Leave alt empty for purely decorative images.
  • Check that the surrounding caption and copy already carry the key facts.

What to measure

The measures below explain why the outcome for “How to write alt text for images” moved, not just that it moved.

  • Image search impressions for descriptive file names and alt text.
  • Accessibility audit warnings for missing alt attributes.
  • Engagement with image-heavy pages.

Where teams go wrong

If you recognise one of these patterns in “How to write alt text for images”, fix it before adding new work on top.

  • Repeating the page keyword in every alt attribute.
  • Writing 'image' or the file name as the description.
  • Putting essential information only inside an image.

Where this fits

Part of the On-page SEO section, this answer to “How to write alt text for images” links to the questions readers usually ask next.

Frequently asked questions

Is alt text a ranking factor?
It helps search engines understand an image and the page context, and it is required for accessibility. It is not a place to win rankings by stuffing keywords. Descriptive, honest alt text is the correct approach.
How long should alt text be?
Usually one short sentence, roughly 5 to 15 words. If the image needs a longer explanation, put that in the caption or the body copy where everyone can read it.
Should I rename image files for SEO?
A descriptive, hyphenated file name is a small clarity gain and makes the media library manageable. It does not replace alt text. Renaming files on a live site can break image URLs, so do it before upload or add redirects.

Sources we checked

These are primary or first-party documents. Where the page describes our own method, it is marked as our experience rather than presented as an official rule.

Something inaccurate or out of date? Tell us and we will correct it.