Add missing alt text to your images

Find every Media Library image without alt text, fill it in on one screen and let older posts use it too.

  • How-to guide
  • AriAccess
  • 2 min read
  • Updated

Use this when the Overview shows images without alt text, or the content check reports Image has no alt attribute. You need the upload_files capability (authors, editors and administrators). Authors can only save alt text for images they uploaded themselves.

  1. Step 1: Open the Alt text tab

    Go to AriAccess→Alt text, or click Add alt text on the Images card of the Overview. The tab lists every image in the Media Library without alt text, 30 per page, newest first, with the file name and the post it was uploaded to.

  2. Step 2: Write the alt text

    Type a short sentence for each image that says what it shows or does. For a logo, use the company name. You can leave an image empty and come back to it later; empty fields are not saved.

  3. Step 3: Save

    Click Save alt text. The images you filled in and are allowed to edit leave the list. Use the page links below the table to go to the next 30.

  4. Step 4: Let older posts use the new alt text

    WordPress copies alt text into a post when you insert the image, so alt text you add later never reaches older posts. Make sure Use Media Library alt text where a post has none is ticked under AriAccess→Fixes. It is on by default. Images marked as decorative (role="presentation") are left alone.

  5. Step 5: Check your content again

    Go to AriAccess→Overview and press Check all content, so the report counts the alt text you added.

    Decorative images

    An image that is only decoration can stay empty in the Media Library. Where it is used in a post, give it an empty alt (alt="") so screen readers skip it.

Find missing alt text in the Media Library

In Media→Library in list view, AriAccess adds an Alt text column, which shows Missing for images without alt text, and a Missing alt text filter link above the list.

Still stuck?

Our helpdesk answers on working days, Norwegian time. Include your WordPress version, PHP version and the page address.

Submit a ticketor email info@arihub.com