---
title: "Describe your images"
description: "Write alternative text for your images in each language of your site, on the Media screen or in the editor, by hand or with AI."
url: "https://www.litetile.io/docs/media/alt-text"
lang: "en"
---

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

- 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.

## 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.](https://media.litetile.app/media/6eee3550-99b4-4494-8fc5-d588d1e67e1e/391e0fb5-e9b4-4abe-9520-33ec0598e7a4.png)

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.

Note

Each **Write with AI** counts toward your monthly AI allowance. See [Your AI allowance](https://www.litetile.io/docs/ai/allowance).

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.](https://media.litetile.app/media/6eee3550-99b4-4494-8fc5-d588d1e67e1e/b61a265e-bd16-4b39-a3ed-fa3178f6deb3.png)

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](https://www.litetile.io/blog/image-descriptions-alt-text).

## 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](https://www.litetile.io/docs/publishing/publish-changes).
