Apollo Editor
Windows 10 & 11 Buy now · $69.95
Images & links

How to Write Good Alt Text for Website Images, With Examples

What alt text is, why it matters for accessibility and search, how to write it for photos, logos, buttons and charts, and when to leave it empty.

Updated 5 minute read The Apollo Editor team

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

  1. Ask why the image is there. Is it showing a product, proving a point, labeling a link, or just decoration?
  2. Write the information, not the pixels. Describe what a sighted visitor would take away from it in this spot on this page.
  3. Keep it short. A phrase or one sentence is usually enough. If you need more, put the detail in the page text.
  4. Do not repeat nearby text. If the caption already says it, the alt text can be shorter or, in some cases, empty.
  5. 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

ImageWeak alt textBetter alt text
Product photoshoeNavy canvas sneaker with white sole, side view
Team photoimage of peopleOur five-person support team at the Denver office
Company logo in the header, linking homelogo.pngBrightside Bakery home
Search button showing a magnifying glassmagnifying glass iconSearch
Bar chart of saleschartSales grew each quarter in 2025, from 120 to 310 orders
Decorative swirl between sectionsdecorative 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 alt attribute 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.

Get three guides like this every month, plus software update notices.Subscribe →