Your Images Are Invisible to Google and Screen Readers: A WordPress Alt Text Guide

Alt text is the little box in the Media Library almost everyone leaves blank. It’s the short written description that stands in for an image when the picture itself can’t be seen — by a blind visitor using a screen reader, by Google trying to figure out what your photo shows, or by an AI assistant reading your page to answer someone’s question. Skip it, and every one of them is left guessing.

Most WordPress sites are riddled with the gap. The last content audit we ran on a mid-sized site turned up more than 1,900 images with no alt text at all — years of blog headers, product shots, and team photos that were effectively invisible to anyone who couldn’t literally look at the screen. Nobody set out to exclude those visitors. The field just never got filled in, upload after upload, for a decade.

Here’s what alt text actually does, why it matters more in 2026 than it ever has, how to write it well, and how to fix a whole library’s worth of missing descriptions without spending a week in the Media Library.

What Alt Text Actually Is

Alt text (short for “alternative text”) is the value of the alt attribute on an HTML <img> tag. In WordPress you set it in the Alternative Text field when you upload or edit an image, and the platform writes it into the markup for you: <img src="team-photo.jpg" alt="Three colleagues reviewing a layout on a laptop">.

It is not the caption, which is visible text printed under the image for everyone. It is not the title attribute, that tooltip almost nobody sees. And it is definitely not the filename — IMG_4821.jpg tells a screen reader nothing. Alt text is a specific, purpose-built slot for describing what an image conveys, and it only surfaces when the image can’t do the job itself.

Where it shows up

You’ll notice alt text in three situations. A screen reader reads it aloud when a blind or low-vision user reaches the image. A browser displays it as placeholder text when the image file fails to load — a broken link, a slow connection, a CDN hiccup. And search-engine crawlers read it to understand a picture they can’t otherwise interpret. Same field, three very different audiences, all depending on what you type into it.

Why It Matters More Than You Think

Alt text used to be filed under “nice to have for accessibility.” That framing undersells it badly, because in 2026 it’s working for at least three audiences at once, and two of them are growing fast.

Screen readers and real people

For someone using JAWS, NVDA, or VoiceOver, alt text is not an enhancement — it’s the entire experience of your image. Without it, a screen reader either says nothing, or, worse, reads out the filename character by character. WebAIM’s annual analysis of the top one million home pages consistently ranks missing alternative text among the most common accessibility failures on the web, year after year. This is not a rare edge case; it’s the default state of most sites.

Google Images and SEO

Google leans on alt text to understand what a picture shows. Its own image SEO documentation states that Google uses alt text, along with computer vision and the surrounding page content, to work out an image’s subject matter — and that descriptive alt text helps images rank in Google Images. Image search is a real, if often ignored, traffic source, and the businesses that write proper descriptions get a quiet edge over the ones shipping alt="" on every product photo.

AI and the machines reading your pages

The newest audience is the LLM-powered search tools and assistants now parsing pages to answer questions. Many of them read the DOM as text, and a described image is one they can actually reason about while a blank one is a dead pixel. Good alt text is fast becoming part of the same “make your content machine-readable” work that structured data does — it helps both the crawler and the model understand what’s on the page.

The Legal Side Nobody Warns You About

Accessibility isn’t only good manners. In the United States, courts have repeatedly treated the Americans with Disabilities Act as applying to websites, and web-accessibility lawsuits filed each year number in the thousands. Missing or useless alt text is one of the most common complaints, because it’s one of the easiest failures to detect automatically.

The technical benchmark almost everyone points to is WCAG — the Web Content Accessibility Guidelines from the W3C. Its very first success criterion, 1.1.1 Non-text Content, requires a text alternative for non-text content, and it sits at Level A, the most basic conformance tier. Alt text isn’t an advanced accessibility feature; it’s the floor.

The stakes got more concrete in 2024, when the Department of Justice issued a final rule under Title II of the ADA formally adopting WCAG 2.1 Level AA as the standard for state and local government websites and apps. Private businesses fall under Title III, where there’s no single adopted technical standard — but courts and plaintiffs routinely reference WCAG 2.1 AA anyway. Whichever way the specifics land for your business, alt text is the part you can’t argue your way out of. It’s Level A, it’s trivial to check, and it’s usually the first thing an accessibility scan flags.

How to Write Alt Text That Actually Works

Good alt text is a skill, not a checkbox. The goal is to convey what the image communicates in its context — not to describe every pixel, and not to stuff keywords. A few principles cover almost every case.

Describe the purpose, not just the picture

Ask what the image is doing on the page. A photo of a chef plating a dish on a recipe page might be alt="Chef spooning sauce over seared salmon". The exact same photo used as a generic banner on an “About” page might just need alt="Restaurant kitchen at service". Context decides the description, so there’s rarely a single “correct” alt for a given file.

Keep it concise

Aim for a short sentence. Screen-reader users don’t want a paragraph read at them for a decorative header, and search engines don’t reward padding. If a picture genuinely needs a long explanation — a complex chart, an infographic — put that detail in the surrounding text or a caption, and keep the alt short and pointed.

Don’t start with “image of”

Screen readers already announce that the element is an image before they read your text, so “Image of a golden retriever” gets read as “image, image of a golden retriever.” Just write “A golden retriever catching a frisbee.” Drop the redundant lead-in.

Some images should have empty alt text

This one trips people up. Purely decorative images — a divider line, a background flourish, an icon that sits next to text already saying the same thing — should have an explicitly empty alt attribute, alt="". That tells a screen reader to skip the image entirely instead of announcing a distracting filename. Empty alt on a decorative image is correct; a missing alt attribute is not the same thing. In WordPress, leaving the field blank on a genuinely decorative image is the right call — the trick is being honest about which images are actually decorative.

Fixing a Whole Library Without Losing a Week

Writing thoughtful alt text one image at a time is fine going forward. The problem is the backlog. A site that’s been publishing for years can easily have thousands of images with the field empty, and no human is going to hand-write descriptions for all of them.

This is exactly the kind of repetitive, visual, judgment-light work that modern AI vision models handle well. A model can look at an image, understand what it depicts, and draft a concise, accurate description — at a pace no person can match across a large library. That’s why we built amplifi.alt, the alt-text feature in our open-source WordPress suite.

How amplifi.alt works

It does two jobs. First, it can generate alt text automatically the moment a new image is uploaded, so your library never falls behind again. Second, it runs a bulk queue over your existing Media Library — processing images in the background on WordPress’s own scheduler so a large job doesn’t time out a single request — and writes a draft description for every image that’s missing one. You review, adjust anything that needs a human touch, and move on. Spend caps (with a sensible daily default) keep the AI cost predictable and small, and a report tells you what changed.

It doesn’t replace judgment — you should still spot-check the results, especially for images where context matters. But it turns “we have 1,900 undescribed images and no realistic way to fix them” into an afternoon.

Where to Start Today

You don’t need a plugin to make progress. Open your Media Library, sort by most recent, and start filling in the field on the images that matter most — the ones on your highest-traffic pages, your product shots, your key landing pages. Fix the images people actually land on first, then work backward through the archive.

If the backlog is genuinely too big to hand-fix, that’s when automation earns its keep. Either way, the important thing is to stop treating the alt field as optional. Every blank one is a small door closed on someone — a blind visitor, a search crawler, an AI trying to help a customer understand what you sell. It costs a sentence to open it.

Frequently Asked Questions

Sitting on a Media Library full of blank alt fields? Generate accurate descriptions across your whole site in an afternoon.

Built by amplifi.studio — see also How to generate schema.org JSON-LD for your whole site with AI.