Menu

Describe your images

At the end of this guide your images have descriptions that screen readers read aloud and search engines and AI assistants use to understand them.

What alternative text is

Alternative text (alt text) is a short description of an image, written for someone who cannot see it. A screen reader reads it aloud, and search engines read it to know what the image shows. Each description holds up to 200 characters.

litetile keeps descriptions in two places: on the file itself, and in the image field of a block (one of the sections of a page).

What alternative text is
WhereWhat it describesUsed when
The Media screenThe file, once for the whole site, in each languageA block shows the image and its own field is empty
An image field in the editorThe image in that one blockAlways, for that block

So describe each file once on the Media screen, and use the editor field only when one block needs different words, for example because the image means something else there.

On the Media screen

  1. Open Media and select the image to open its details.
  2. Under Alt text, choose the Language to write in.
  3. Type the description in Alt text.
  4. Choose Save. The panel says "Alt text saved. It reaches the site at the next publish."
The Media screen: details panel with alt text.

If your site has more than one language, choose each language in turn and write the description in it. A page in a language with no description uses the description of your site's default language.

Write it with AI

  1. In the details panel, choose the language.
  2. Choose Write with AI. AI looks at the image and writes a Suggestion.
  3. Choose Use this text to save it, or Dismiss to drop it.

Read every suggestion before you use it. AI does not know your business details unless the image shows them, such as the name of the street in a photo of your shop.

Write with AI is offered for photos and other raster images, not for SVG drawings or videos. Describe those by hand.

In the editor

  1. Select the block and find its image field.
  2. Type in Alternative text. It is saved with the page, in the page's language.
  3. To have AI write it, choose Write the alternative text with AI beside the field, then Accept or Dismiss the suggestion.
The Alternative text field of an image in the editor.

To go back to the description from the Media screen, choose Clear the alternative text.

When to leave it empty

An image that only decorates, such as a pattern or a background texture, does not need a description. A screen reader skips it.

The page checks warn when an image has none: "This image has no alternative text. Add one so screen readers and search engines can describe it." The warning never stops you publishing.

What to write

  • Say what the image shows that matters on this page: "A mechanic adjusting the brakes of a city bike."
  • Do not start with "Image of" or "Photo of". The screen reader already says it is an image.
  • Keep it to one sentence.
  • Put text that appears in the image into the description.

For more examples, read Image descriptions (alt text): what to write and why.

Publish

A description written on the Media screen goes live when you publish Media changes ("Files deleted, replaced or described differently"). A description typed in the editor goes live with that page. See Publish changes.