How to Add Alt Text to Images on WordPress
Published · Updated
Alt text is a short description attached to an image. Search engines cannot see pictures the way people do, so alt text tells them what the image shows. It also lets screen readers describe the image to visually impaired visitors.
The fix on WordPress
Click the image in the Media Library or block editor and fill in the "Alt Text" field in the sidebar.
Builder menus change over time. If a label looks different, look for the closest option and check WordPress's help centre.
What this usually looks like on WordPress
Alt text on WordPress is stored in two places that people mix up: the Alt Text field in the Media Library, which is the default for new uses of that image, and the alt text saved inside each post or page where the image was inserted. Changing one does not always change the other, which is why a site can have "fixed" its alt text and still show gaps when you view the source.
Why this matters
Google cannot "see" images the way people do - alt text is how it understands what is in the picture. It also helps visually impaired visitors using screen readers.
Common mistakes on WordPress
Fixing the Media Library only
Changing the alt text on an image in the Media Library does not rewrite the posts that already use it. Edit the image block in each post, or re-insert the image.
Writing alt text for search engines
A string of keywords helps nobody and reads as stuffing. Describe what the image shows in a short, natural phrase, in the context of the page it sits on.
Describing decorative images, or leaving informative ones empty
Purely decorative images, such as dividers, should have an empty alt attribute so screen readers skip them, and the block editor has a toggle for that. Images that carry information, such as a chart or a product photo, need a real description.
How to check it worked
- Right-click an image, choose Inspect, and look for an alt attribute with a meaningful description.
- Run the free Site Check, which reports how many images on the page are missing alt text.
View the page source and search for "<img" to spot images with no alt attribute at all. An empty alt="" on a decorative image is correct. Then read the page using only the alt texts and check it still makes sense. For a large library, start with the pages that get the most traffic in Search Console and work through the rest in batches. A plugin can list images missing alt text, but write the descriptions yourself or review any generated ones, because automatic descriptions can be wrong.
Common questions
How long should alt text be?
A short, specific description, usually under about 125 characters. Describe what the image shows and skip phrases like "image of".
Do decorative images need alt text?
Purely decorative images can have an empty alt attribute so screen readers skip them. Anything that carries information should be described.
Same fix on other builders
More fixes for WordPress