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.
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).
| Where | What it describes | Used when |
|---|---|---|
| The Media screen | The file, once for the whole site, in each language | A block shows the image and its own field is empty |
| An image field in the editor | The image in that one block | Always, 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.
- Open Media and select the image to open its details.
- Under Alt text, choose the Language to write in.
- Type the description in Alt text.
- Choose Save. The panel says "Alt text saved. It reaches the site at the next publish."

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.
- In the details panel, choose the language.
- Choose Write with AI. AI looks at the image and writes a Suggestion.
- 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.
- Select the block and find its image field.
- Type in Alternative text. It is saved with the page, in the page's language.
- To have AI write it, choose Write the alternative text with AI beside the field, then Accept or Dismiss the suggestion.

To go back to the description from the Media screen, choose Clear the alternative text.
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.
- 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.
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.
