# Alt text: how should you describe the images on your website?

> Alt text describes an image for screen-reader users and for Google. When to write it, when to leave it empty, a worked calculation and the most common slips.

Updated on October 15, 2026 · https://app.pilotiko.com/en/glossary/alt-text

Alt text is the value of an HTML image's alt attribute (<img alt="…">). It tells people who can't see the image, including screen-reader users, what the picture contributes to the page, and it helps Google understand the image. A purely decorative image gets an empty alt attribute rather than a description or no attribute at all.

## In short
- WCAG Level A requires an equivalent text alternative for non-text content.
- Google calls alt text the most important attribute for supplying image metadata.
- Decorative image: an empty alt (alt=""), not a missing attribute.
- Image inside a link or button: describe the destination or the action.
- Google advises against stuffing keywords into alt attributes.

## Who is alt text for?

People first. Success Criterion 1.1.1 of the Web Content Accessibility Guidelines (WCAG), a Level A requirement, says all non-text content presented to users needs a text alternative that serves the equivalent purpose, with a few exceptions such as controls, time-based media and decoration [3]. A screen reader speaks the alt value aloud wherever the image appears.

Search engines second. Google says alt text is the most important attribute for providing metadata about an image, that it combines alt text with computer-vision algorithms and page content to work out what an image shows, and that alt text acts as anchor text when an image is a link [1]. Google also notes that it helps people on connections too slow to load images [1].

## How do you decide what goes in the alt attribute?

The W3C offers a decision tree built on a few questions [2]. Does the image contain text? Is it inside a link or button? Does it add meaning to the page? Is it purely decorative? Your answers point to one of the categories below.

| Image role | Service-business example | Alt value |
|---|---|---|
| Informative | Photo of an installed ductless heat pump | A brief description of the meaning: “Wall-mounted heat pump above a patio door” |
| Functional (in a link or button) | Phone icon that starts a call | The action: “Call customer service” |
| Image of text | Banner reading “Free inspection in April” | The text in the image, word for word |
| Decorative | Leaf pattern in the background | Empty: alt="" |
| Complex | Chart of response times | A short summary, with the detailed data elsewhere on the page |

Categories from the W3C images tutorial [2]. Examples are fictional.

## How do you write good alt text?

Google walks through a puppy example: no alt attribute is bad; a pile of breed names and keywords is also bad; the single word “puppy” is better; a specific phrase describing the puppy and what it is doing is best [1]. The same logic applies to a roof, a renovated kitchen or an interlock driveway: say what the image shows, in the page's own vocabulary, and stop there.

There is no need to open with “Image of” or “Photo of”, since screen readers already announce an image. And when the same information sits in text right beside the picture, an empty alt spares the listener from hearing it twice [2].

## How many images actually need a description?

**Calculation: the photo gallery of a fictional roofer in Rimouski**

- Images on the site : 48
- − Decorative images (patterns, dividers, backgrounds) : − 11
- − Logos and icons paired with visible text : − 7
- = Images that carry meaning and need a description : 30
- Writing time at roughly 1 minute per image : ≈ 30 minutes
- **= About thirty descriptions to write, and 18 images that simply get alt="".**

## Which alt text mistakes should you avoid?

- Leaving the alt attribute out, so the image has no text alternative even though criterion 1.1.1 calls for one [3]; Google lists this among its “bad” examples too [1].
- Stuffing it with keywords (“roofer Rimouski roofing shingles cheap”); Google calls this keyword stuffing [1].
- Describing a button icon by its look (“magnifying glass”) rather than its function (“Search”) [2].
- Pasting the same alt text onto every photo in a gallery.
- Putting essential details, such as a phone number or price, only inside an image.

## Is alt text enough for image search?

No. Google also draws on captions, the page title, nearby text and, very lightly, the file name [1]. A photo placed next to the paragraph that discusses it, on a page about the same topic, is easier to understand. Alt text works alongside a solid [title tag](https://app.pilotiko.com/en/glossary/title-tag) and [structured data](https://app.pilotiko.com/en/glossary/structured-data); it doesn't replace them. For link previews, look at the og:image:alt property in [Open Graph](https://app.pilotiko.com/en/glossary/open-graph).

## What does Pilotiko do with alt text?

The audit of your current site counts, page by page, the images missing alt text and lists the fix as a priority for both accessibility and image search. On the site Pilotiko builds and hosts, the pre-publication quality check flags any image without an alt attribute, and any non-logo image left without a description. You can get a first read with the [visibility audit](https://app.pilotiko.com/en/tools/google-ai-visibility-audit).

## Frequently asked questions

### How long should alt text be?

No standard sets a character count. One short phrase is enough for an informative photo. If the image packs in a lot of information, like a chart, summarize it in the alt attribute and give the detail on the page.

### Does my logo need alt text?

If the logo links to the home page, its alt text should name the destination or the business. If the business name already appears as text right beside it, an empty alt avoids repetition.

### Is alt text legally required in Canada?

WCAG is an international accessibility standard, and whether it is mandatory depends on the type of organization and the rules that apply to it. For a private small business, it is first and foremost good practice that makes the site usable by more customers.

### Should alt text start with “picture of”?

No. Screen readers already announce that it is an image. Start with what the image actually shows.

### Does alt text help in Google Images?

Yes. Google uses it, together with page content and computer vision, to understand what an image is about. It guarantees no ranking, but an image without alt leaves Google guessing.

## Sources

1. Google Search Central, « Image SEO best practices », https://developers.google.com/search/docs/appearance/google-images (accessed on 2026-10-15)
2. W3C Web Accessibility Initiative (WAI), « An alt decision tree », https://www.w3.org/WAI/tutorials/images/decision-tree/ (accessed on 2026-10-15)
3. W3C Web Accessibility Initiative (WAI), « Understanding Success Criterion 1.1.1: Non-text Content (WCAG 2.2) », https://www.w3.org/WAI/WCAG22/Understanding/non-text-content.html (accessed on 2026-10-15)
