Kayabyte

How to fix alt text, headings and link names in Wix

By Kayabyte

A café’s home page has a photo of the menu, four icon buttons and a heading that is really a bold paragraph. A sighted visitor understands it at once. A screen reader says “image”, “link”, “link”, “link”, “link” and finds no headings to jump between. Three small fixes change that. This guide gives the steps in the Wix Editor, Wix Studio and Wix Harmony, as far as Wix’s help describes them. All steps are as described at the time of writing.

Image alt text

Alt text is a short description that a screen reader reads aloud in place of the image.

Wix’s help page Accessibility: Preparing Your Images and Galleries gives these steps for single images in the Wix Editor and Studio Editor:

  1. Click the image on your page.
  2. Open the Settings icon.
  3. Type a description in the “What’s in the image?” field.
  4. Press Enter, then publish the site.

Wix’s writing tips: say what matters about the image, be specific, keep it short and do not start with “image of”. Give each image on a page its own text.

Decorative images do not need alt text. Wix says to mark them in the Accessibility Wizard, under Detected issues, “Add alt text to images”, by ticking “This image is decorative, it doesn’t need alt text”. Do not mark an image as decorative if it is also a link.

For Harmony, the article does not give separate steps, as far as I could find. The Wizard route above is described for the Editor.

Gallery alt text is set in the Media Manager. In the Editor and Studio Editor, click the gallery, then Manage Media or Change Images, select an image and enter a title on the right. The article adds that for the Wix Pro Gallery only you can change the alt text under “Alt Text” if it should differ from the title.

Heading tags

Wix’s page Accessibility: Preparing Your Site Structure says every page should have an H1 and that tags should then follow in order. Put the H1 in the page body, not in the header, because a header appears on every page.

To set a tag:

You can also use the Accessibility Wizard in any editor: scan the site, open Detected issues, choose the page, click Organize heading structure and pick a tag for each text element. If you break a heading over two lines, press Shift + Enter. Enter creates a second heading.

The page language

In a single-language site, go to the dashboard settings, then Language & Region, and use the Site language drop-down. You can also change it in the Wizard under Site level, Main site language, then Edit. Wix says these Wizard steps are the same in the Editor, Studio and Harmony. See Accessibility: Setting and Managing Your Site’s Language. With Wix Multilingual, the main language chosen at setup cannot be changed.

This is the hardest of the four. Wix lists “descriptive text for links and buttons” as a manual task in the Wizard (Using the Accessibility Wizard), so the Wizard will not find these for you.

The simplest fix is to use clear visible text. “View the lunch menu” is better than “Click here”. For an icon-only link, I could not find a Wix help article with exact steps for adding an accessible name in the Editor, Studio or Harmony. Wix’s page on ARIA attributes says that, in the Studio Editor, you need developer mode and the Code panel to add attributes. It lists labels for elements such as the Lightbox, Container Box, Strip and Repeater. It says the Text Button has no label attribute. So the safest route is to give icon buttons visible text, or to ask Wix support.

Where the audit helps

Wix’s Wizard works from the editor. It cannot scan the CMS, apps, Velo, the checkout or secondary languages. A site-wide list of problems on the published pages can fill part of that gap.

Full disclosure: Kayabyte makes Accessibility Widget & Audit, so I describe it in more detail than the other options. Other accessibility apps exist in the App Market.

The audit reads your published pages. It lists problems under these headings:

Each finding shows the page, a short snippet of the element and where to fix it in Wix. For alt text it points to the image settings or Media Manager. For headings it points to the text tag setting. For the language it points to Language & Region. Pro keeps history, so you can see what was fixed since the last scan.

The audit does not check colour contrast, keyboard use or anything behind a login, the checkout or the side cart. No tool on its own makes a site meet WCAG.

Worked example

The café’s owner scans the site. The audit lists 14 findings across 5 pages. Six are images with no alt text, four are links with no name (the icon buttons), two are pages with a second H1 and two are pages with the same title. She fixes the alt text in the image settings, turns the extra H1s into H2s in the text settings, and writes real titles in the page SEO settings. She replaces the icon links with buttons that have text. She publishes and scans again. The list is empty, and she still tabs through the site herself.

Plans

Free: full toolbar, an audit of 5 pages and the statement generator. Pro is $5.99 per month, or $4.99 per month billed yearly, with a 14-day free trial. It adds an audit of up to 200 pages with history, a custom colour and offsets for the button, and hiding the “by Kayabyte” link. If you open the toolbar from your own #accessibility link (which works on every plan), Pro also lets you hide the floating button. Billed by Wix.

Get Accessibility Widget & Audit on the Wix App Market.

FAQ

Do I need alt text on every image? Not decorative ones. Wix says to mark those as decorative in the Wizard.

Can I use more than one H1? Wix says every page should have an H1. Keep to one so the structure is clear.

Will the audit change my site? No. It only reads the published pages.

Wix help checked on 7 November 2026. Wix changes its editors often.