How accessible is your website?Start free check
Documentation

Choose how image descriptions are written

Set the language, writing style, extra instructions and a fixed text before or after the AI's image descriptions, and update descriptions written earlier.

Updated October 22, 2026

You decide how allyWay's AI writes image descriptions (alt text) for your website: in which language, how long, what to always mention and which text to add to each one. This page shows where to set it and how to update descriptions the AI wrote before.

Before you start

  • An active plan – the AI writes image descriptions only with one.
  • The settings belong to one website. Choose it in the website switcher at the top of the left menu first.

Change the settings

  1. Open the settings

    Open the Alt text page and click Settings in the top bar – or the AI fixes left button next to the page title. The panel Alt text settings opens.

  2. Change what you want

    The panel shows how many AI fixes the website has left this month and the settings described below. Text before and Text after are under Advanced.

  3. Save

    Click Save. You see "Alt text settings saved". Cancel discards your changes.

What each setting does

Setting What it does
Auto-generate on every scan New images without alt text get one automatically, 1 AI fix per image. It's marked Recommended and is the same switch as Fix with AI automatically in the Settings of the Report.
Language The language of the descriptions – and of every name the AI writes for links, buttons, form fields and other elements. The default is Page language; you can choose from 41 languages.
Writing style How long the descriptions are: Standard, Short or Detailed.
Extra instructions Optional wishes for the AI, up to 500 characters, for example "Always mention the brand name."
Text before / Text after A fixed text of up to 60 characters added to every new AI description, for example a photo credit like "© Sam Smith Photography –". As the panel says: "Added to newly generated alt texts."

Writing style, Extra instructions, Text before and Text after only apply to image descriptions, not to names. Decorative images and descriptions you write yourself get no text before or after.

Writing styles

Style Example At most
Standard (the default) One short sentence: "A wooden chair with a curved backrest." 100 characters
Short A few words: "Wooden chair." 80 characters
Detailed One or two fuller sentences: "A light oak dining chair with a gently curved backrest and slim legs." 250 characters

A text before or after comes on top of these limits. Checking tools flag alt texts of more than about 100 characters as long. Descriptions allyWay wrote longer before are shortened at the next run, for free.

Extra instructions

The AI follows your instructions unless they clash with its basic rules: describe what matters to someone who can't see the image, include important readable text, keep to the length of the writing style, never start with "Image of", "Picture of" or "Photo of", and use no quotation marks, emojis, hashtags or file names. The AI only sees the picture, its file name and the page address – it can't know names of people, products or places unless they're visible or you tell it.

Which language the AI writes in

allyWay decides in this order:

  1. The language you chose under Language.
  2. With Page language: the language your page declares in its code.
  3. The language most of your checked pages declare.
  4. None known: names follow the language of the page's own text, and image descriptions are written in English.

On a website with several languages, keep Page language, so each page's images and elements get texts in that page's language. One image file has one description, though: if the same file is used on pages in different languages, it's described once, in one language.

Update descriptions written before

Settings only apply to descriptions and names the AI writes from now on – nothing on your website changes without you asking for it. To update image descriptions:

  1. Filter the images

    On the Alt text page, filter With alt text.

  2. Select them

    Tick the images you want to update. Regenerating replaces the current text, also a text you wrote yourself – so don't select those if you want to keep them.

  3. Generate them again

    Click Generate selected (n). Each image uses 1 AI fix.

Names for links, buttons and other elements don't change with a new language. To change one, open the Report, click View next to its issue in Fixed by AI, then See every change, and click Edit.

Check that it works

Open Settings on the Alt text page again: your choices are saved. New descriptions follow them – for example after Generate selected (n) for one image.

The AI wrote in the wrong language – how do I fix it?

Your pages probably declare no language in their code – then image descriptions fall back to English – or the wrong one; some themes mark every page as English. Choose your language under Language and click Save, then generate the affected descriptions again as described above. The lasting fix is to set your page's language in your website's code; that also helps screen readers pronounce your text correctly.

Do the settings apply to all my websites?

No. Settings are per website. Choose another website in the website switcher to set its own.

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