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
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.
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.
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:
- The language you chose under Language.
- With Page language: the language your page declares in its code.
- The language most of your checked pages declare.
- 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:
Filter the images
On the Alt text page, filter With alt text.
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.
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.