How accessible is your website?Start free check
Documentation

Add image descriptions (alt text)

Let allyWay's AI describe the images on your website, write or change descriptions yourself, and see what each status on the Alt text page means.

Updated October 22, 2026

An image description – alt text – tells people who can't see an image what it shows. On the Alt text page you let allyWay's AI describe your images, write descriptions yourself and see what each image has.

Before you start

  • An active plan. During the free trial you can write descriptions yourself – they go live on your website once you have a plan – and the AI buttons stay grayed out.
  • allyWay installed on your website, for the AI – see Check that allyWay is installed. Your own descriptions go live once the widget runs there.
  • A check of your website: every check collects the images of the pages it reads.

Find your images

Choose the website in the website switcher, then click Alt text in the menu. Each row shows a preview, the file name, the page it's on, the description, the status and buttons, newest first. Next to the title you see how many AI fixes are left – see Your AI fixes per month. Settings in the top bar decides how the AI writes – see Choose how image descriptions are written.

Use the filters All, With alt text and Missing alt text, or Search images by file name, page or description.

Status What it means
Missing The image has no description.
Generating… The AI is writing it now.
AI generated allyWay's AI wrote it, and it's live.
Edited You wrote it in allyWay, and it's live.
Original Your website's own description – visitors get it, and the AI leaves it alone.
Decorative No description needed.
Not supported The AI can't describe it – SVG graphics and tiny images such as tracking pixels. You can write one yourself.

Let the AI describe the missing images

  1. Clear the selection

    If images are ticked, click Clear selection.

  2. Click Generate missing

    Click Generate missing (80) in the top bar. The AI describes every image without a description, using 1 AI fix per image. With more than 500 missing, the button says for example Generate missing (500 of 800): click again for the rest.

  3. Let it run

    You'll see "Generating 80 alt texts…", and the rows fill in by themselves – you can leave the page. At the end: "80 alt texts generated — live on your website."

When nothing is missing, the button says All images described.

Describe only some images

Tick the images and click Generate selected (3) – up to 500 at a time, 1 AI fix each. For one image, click Generate in its description column, or the round-arrow button (Regenerate · 1 AI fix) for a fresh description. A new description replaces the current text – also yours, or your website's own description, which allyWay's text then replaces on your live page. Generate missing and the automatic mode never replace your website's own descriptions.

Write or change a description yourself

  1. Open the image

    Click the pencil button at the end of the image's row. The window Edit alt text opens.

  2. Type your description

    Write it into Alt text – up to 300 characters.

  3. Save

    Click Save. Your text is free and goes live on your website right away; the status changes to Edited.

To take allyWay's description back, empty the field and click Change back. allyWay's text comes off your website, your website's own description (if it has one) is used again, and the AI doesn't write a new one for that image. The row then shows the text you took back ("Changed back: …"): to put it back, click the pencil button, keep the text and click Save – it goes live as your own text.

Decorative images

A decorative image adds no information – a pattern, a divider line, an ornament – and should have an empty description, so screen readers skip it. When the AI finds an image purely decorative, it gives it one: "Decorative — no alt text needed (checked by AI)". That decision uses 1 AI fix. Images your website marks as decorative show "Marked as decorative on your website" and are never sent to the AI.

An empty alt="" alone doesn't count: many website systems, such as WordPress, add it to every image without a description, so allyWay lists those images as Missing. Only role="presentation", role="none" or an area hidden from screen readers (aria-hidden="true") marks an image as decorative – there's no button for it in allyWay. If the AI described a decorative image, use Change back.

Check that it works

The image's status changes to AI generated or Edited, with the description in its row. To find it on your live page, see When the AI can't fix something.

Why is the page empty, or why are some images missing?

Before the first check, the page shows "No images yet" with Go to Report – start a check there. Only real images in your pages are listed: not background images of your design or images inside embedded content, such as maps. Our checks don't log in and skip pages like the cart or checkout.

Does an image on many pages use several AI fixes?

No. An image file counts once: one row, one description, 1 AI fix – used on every page that shows it. Different files of the same photo, such as the sizes many website systems create, are separate rows.

Why don't some previews show?

Some websites don't let other sites show their images, or the image no longer exists. You then see a gray picture icon – the description works as usual.

Still stuck?

Our support team replies within a few hours.

Contact support

Installation helper

Step-by-step setup guides for your platform.

Open the helper