To write alt text for an image, describe what the image communicates in its context, in a short phrase or sentence, as if you were reading the page aloud to someone who cannot see it. Skip phrases like "image of", leave out details that do not matter, and use an empty alt="" for purely decorative images. If the image is a link or button, describe what it does rather than how it looks.
This guide explains what alt text is for, gives examples for photos, logos, buttons, charts and decorative images, and lists the mistakes to avoid.
What alt text is and why it matters
Alt text is the value of the alt attribute on an <img> element, for example <img src="dog.jpg" alt="Golden retriever catching a frisbee">. It does several jobs:
- Screen readers read it aloud, so blind and low-vision visitors get the same information as everyone else.
- Browsers show it when an image fails to load, such as on a slow connection or after a broken path.
- Search engines use it, together with the surrounding text, to understand what an image shows.
Providing a text alternative for images is one of the first requirements in the Web Content Accessibility Guidelines (WCAG), so it is a core part of any accessible site.
A simple method for writing good alt text
- Ask why the image is there. Is it showing a product, proving a point, labeling a link, or just decoration?
- Write the information, not the pixels. Describe what a sighted visitor would take away from it in this spot on this page.
- Keep it short. A phrase or one sentence is usually enough. If you need more, put the detail in the page text.
- Do not repeat nearby text. If the caption already says it, the alt text can be shorter or, in some cases, empty.
- Read it out loud with the page. If it sounds natural in the flow of the content, it is probably right.
The same photo can need different alt text on different pages. A photo of a chef in a kitchen might be "Head chef Maria plating the tasting menu" on a restaurant's About page, and "Open kitchen with six cooking stations" on a page about venue hire.
Examples for common image types
| Image | Weak alt text | Better alt text |
|---|---|---|
| Product photo | shoe | Navy canvas sneaker with white sole, side view |
| Team photo | image of people | Our five-person support team at the Denver office |
| Company logo in the header, linking home | logo.png | Brightside Bakery home |
| Search button showing a magnifying glass | magnifying glass icon | Search |
| Bar chart of sales | chart | Sales grew each quarter in 2025, from 120 to 310 orders |
| Decorative swirl between sections | decorative swirl graphic | (empty: alt="") |
Photos
Mention the subject and any detail that matters for the page, such as color for a product or the setting for an event. You rarely need to describe lighting, camera angle or background unless they are the point.
Logos
Use the organization's name. If the logo links to the home page, the link's purpose is the important part, so "Brightside Bakery home" works well. You do not need the word "logo".
Buttons and linked images
When an image is the only thing inside a link or button, its alt text becomes the link or button name. Describe the action: "Download the brochure (PDF)", "Next photo", "Search". Describing the picture ("arrow pointing right") does not tell the visitor what will happen.
Charts, graphs and infographics
Give the main takeaway in the alt text, then put the full data in the page as a table or a short paragraph. Alt text is not a good place for long lists of numbers, and many visitors who can see the chart also benefit from the text version.
Images of text
If an image contains words, such as a banner or a quote graphic, the alt text should include those words. Better still, use real HTML text styled with CSS where you can, because it scales and translates properly.
When alt text should be empty
Some images add nothing that the text does not already say: background flourishes, divider lines, generic stock photos used only for mood, or an icon right next to a text label that says the same thing. For these, use an empty alt attribute: <img src="divider.svg" alt="">.
An empty alt is not the same as a missing alt. If you leave the attribute out entirely, many screen readers read the file name instead, such as "IMG underscore 4032 dot jpeg". The empty value tells assistive technology to skip the image on purpose.
Decorative images that are only there for visual style can often be added as CSS backgrounds instead of <img> elements. Then no alt attribute is needed at all.
Common mistakes to avoid
- Starting with "image of" or "picture of". Screen readers already announce that it is an image.
- Using the file name. Text like "hero-final-v2.jpg" helps nobody.
- Keyword stuffing. A list of search phrases is unpleasant to hear and does not help search either. Write for people first.
- Writing an essay. Long descriptions are tiring to listen to. Put extended detail in the page or a caption.
- Repeating the caption word for word. Visitors using screen readers would hear the same thing twice.
- Forgetting linked images. A linked image with no alt text is a link with no name, which is confusing to navigate.
The easier way: add alt text as you insert images in Apollo Editor
The best time to write alt text is the moment you add an image, while you still know why it is there. Apollo Editor puts the alt text field right where you set up each image.
- Insert an image by drag and drop or Insert Image on the main toolbar, then fill in alt text in the Image Properties dialog.
- Edit alt text for an image link in the same place, alongside the link settings.
- Use Split mode to see the
altattribute in the HTML while you work on the page visually. - Use site-wide search to find images across your pages and review their alt text.
Good alt text is a small habit that makes a big difference. For more, see the website accessibility checklist, how to insert an image in HTML and which image format to use.
Frequently asked questions
How long should alt text be?
Usually a short sentence or phrase. Describe what matters about the image in context rather than every detail.
Should every image have alt text?
Every img should have an alt attribute. Purely decorative images should use an empty alt so screen readers skip them.
Does alt text help SEO?
It helps search engines understand images, but write it for people first. Stuffing keywords into alt text does not help.
