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.
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?
How long should alt text be?
Should I rename image files for SEO?
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.