Pilotiko feature : available

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

A short phrase in the image code that stands in for the picture when someone can't see it.

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.

Try the free toolTry 30 days free

By Pilotiko editorial team · Updated on

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.

What to put in alt depending on the image's role (based on the W3C decision tree)
Image roleService-business exampleAlt value
InformativePhoto of an installed ductless heat pumpA brief description of the meaning: “Wall-mounted heat pump above a patio door”
Functional (in a link or button)Phone icon that starts a callThe action: “Call customer service”
Image of textBanner reading “Free inspection in April”The text in the image, word for word
DecorativeLeaf pattern in the backgroundEmpty: alt=""
ComplexChart of response timesA 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?

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.

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.

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 (accessed on October 15, 2026).
  2. W3C Web Accessibility Initiative (WAI), An alt decision tree (accessed on October 15, 2026).
  3. W3C Web Accessibility Initiative (WAI), Understanding Success Criterion 1.1.1: Non-text Content (WCAG 2.2) (accessed on October 15, 2026).

Your whole business, on one screen.

Each department is a room. Pilotiko prepares the work; you approve with one click.

Try 30 days free

The Pilotiko office of a sample company: each department is a room.
  • Call answered
  • Appointment confirmed
  • Email reply ready
  • Invoice prepared

Try the office with your team

30 days free.

Try 30 days free