Docs SEO
Image alt text
Checks that the images on your homepage have alt attributes, which screen readers read aloud and search engines use to understand images.
What it checks
We count every <img> in the homepage HTML and how many have no alt attribute at all. An empty alt="" counts as set, which is right for decorative images. Images added by JavaScript and CSS background images are not counted.
- PassEvery image has an alt attribute, or there are no images.
- WarningSome images have no alt, up to 30% of them.
- FailMore than 30% of images have no alt.
Why it matters
Screen readers read the alt text aloud; without it, they read the file name or skip the image. Alt text also shows when an image fails to load, and search engines use it to understand what an image shows.
How to fix it
Describe what each meaningful image shows in a few words, as you would to someone who cannot see it. Give decorative images an empty alt="" so screen readers skip them. Do not stuff keywords in.
Platform notes
Fill in Alternative Text in the media library or the image block. Text added in the media library later is not copied into posts that already use the image.
Add alt text to product media from the product page, and to theme images in the theme editor.
Set alt text on the image in the asset panel or in the image's settings.
Each image's settings have an alt text field.
next/image requires an alt prop; pass a real description, not the file name.
Your report shows what this check found on your site. Pro shows the exact fix for your site. See pricing.
Free, about 30 seconds, with every other check included.