Alt Tags

Alt text is a short description of an image. Screen readers read it aloud to visitors who can't see the image, browsers show it when the image doesn't load, and search engines use it to understand the image.

Open the report under Real Time Reports > Alt Tags. It lists every page with at least one image that has no alt text. It checks images placed in the text editor and image fields such as a page's feature image.

How to fix it

1. In the report, find the page and select Edit in its row.
2. Find the image without alt text. A yellow message at the top of the edit form lists what the report found on this page.
3. For an image in the page text, select Edit on its section under Content Sections, then select the image, then select Change image alternative text in the small toolbar that appears above it.
4. For an image field (for example, the feature image), type into the Alternative text box under the image.
5. Write the alt text, then select Save at the top of the edit form.

Writing good alt text

• Describe what the image shows and why it's on the page, in one short sentence.
• Don't start with "Image of" or "Picture of". Screen readers already say it's an image.
• If the image contains words (a flyer, a sign, a chart), include those words, or put them in the page text.
• Don't use the file name, such as "IMG_2041.jpg".

Good to know

• The report also lists images marked as decorative (with empty alt text). If an image adds information, give it alt text. If it's purely decoration, it's better to remove it from the page.
• After you save, the report updates in the background, usually within a few minutes. Reload the report to check.