How accessible is your website?Start free check
Documentation

Names and labels for screen readers

Which names and labels allyWay adds for links, buttons, form fields and more, what they cost, and how to change or remove one.

Updated October 22, 2026

Screen readers announce every link, button and form field by its name. When an element has none – an icon link, for example – people only hear "link" or "button". allyWay gives such elements a short name that only screen readers read. Your website looks exactly the same.

Before you start

  • An active plan. The free trial has no fixes.
  • allyWay installed on your website: the names go live through allyWay's widget – see Check that allyWay is installed.

What allyWay names

Without a name What allyWay adds
Links with only an icon or picture – social media icons, a logo link, gallery thumbnails A name of 1 to 6 words, such as "Instagram" or "Open photo 3 of the gallery".
Buttons with only an icon – menu, search or close – and elements that work like a button A name of 1 to 5 words, such as "Open menu" or "Add to cart".
Form fields – input boxes, drop-down lists, checkboxes, radio buttons, switches A label such as "Email address" or "Sort by". Words visible right next to the field are used exactly as they are; a field whose only label is its tooltip gets that tooltip.
Dialogs, progress bars, meters and the items of a fold-out list A name such as "Cookie settings" or "Upload progress". A dialog with a heading is named by its heading.
Embedded frames – a YouTube video, a map, a booking form A title such as "Map of our store". What's inside the frame isn't changed.
Icons and graphics drawn with code, image buttons, the clickable areas of an image map, embedded content A description such as "Company logo" or "Rated 5 of 5 stars". A purely decorative icon or graphic is hidden from screen readers instead – never anything visitors can use.
Empty headings Their text, written from what follows, such as "Our services". An empty heading below the main heading that only makes space is no longer announced as a heading.
Empty table headers A header text only screen readers get, such as "Price". The empty top-left corner cell of a table whose first row and column are headers becomes a plain cell.
Content outside the page areas A skip link or "back to top" link gets a small page area of its own, a skip link that leads nowhere is pointed at your main content, and a part of the page is marked as your main content, header or footer – or gets a page area with a name such as "Customer reviews".

The page language: when your pages don't state their language, allyWay sets it on every page, so screen readers pick the right voice. It uses what your pages or your AI settings already say – only when nothing says it does the AI tell the language from the page's text. A page that states its own language keeps it, and allyWay sets none where it would change how text looks, such as word breaks or quotation marks.

How allyWay adds the names

  • Only where the element has no name of its own: visible text, its own hidden name, a tooltip or a described picture inside always win. Text your page hides from everyone, such as the word of an icon link your theme hides, doesn't count.
  • In your page's language, never with words like "link", "button", "icon" or "image".
  • Page areas only where allyWay tried them on your page and nothing you see changes. A name visitors would see – for example because your theme styles named areas – waits for your OK in To approve on the Report page. See How AI fixes work.
  • We recognize an element by its code – for example where a link leads –, never by its text. If that code changes, it's a new element: with Fix with AI automatically on, the AI names it after the next check.

What it costs

Each element the AI names uses 1 AI fix – once, even if it's on every page, like the menu button in your header. So does each other part of the page the AI gives a page area, and marking a graphic as decoration or an empty heading as spacing: the AI made that decision. The page language uses 1 AI fix for the whole website, only when the AI tells it from the text.

Free: a tooltip used as a label, a dialog named by its heading, an empty corner cell, a page language your pages or your AI settings already state, the page areas of links, a skip link's target and marking your main content. See Your AI fixes per month.

Change or remove a name

  1. Find the name

    Open the Report, click View next to the issue in Fixed by AI, then See every change. Each change says what allyWay did, for example "Named a link" or "Labeled a form field".

  2. Click Edit

    A window for that kind of element opens, for example Edit link name, Edit field label or Edit page language. For a graphic or heading marked as decoration, the field starts empty: a name you write replaces the marking.

  3. Type your text and save

    Type up to 120 characters – for the page language, a code such as en, de or de-AT – and click Save. Your text is live right away and free.

  4. Or change it back

    Empty the field and click Change back, or click Change back next to the change. The name comes off your website, and the AI doesn't write it again by itself. Use AI version there brings it back.

Check that it works

After a check with allyWay on your website, the names show on the Report under Fixed by AI. If a later check still finds an element without a name, the Report lists it under To fix on your website.

Why can't I find the names in my page's source code?

allyWay's widget adds them in each visitor's browser, so "View page source" shows your original code. Right-click the element on your website and choose "Inspect" to see its name.

Can the AI write a name again?

No, names can't be regenerated. Edit the name yourself – your text is free.

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