How to add alt text in bulk using Ally

Last Update: March 31, 2026

This post has been translated using machine translation, which may result in minor inaccuracies or differences in wording compared to the original. We apologize for any errors or ambiguities. Please feel free to contact us if we can clarify anything for you.

This process walks through scanning a WordPress page for accessibility issues, opening the bulk alt text management modal, and updating image alternative text (alt text) using manual entries, decorative markings, and AI-generated descriptions.

Alternative text, often shortened to alt text, is a concise written description of websites images. It is an HTML attribute applied to image tags that provides a text alternative for the visual content. For screen reader users, alt text offers an audio description of what is on screen, ensuring they do not miss relevant visual details and hear only the word “image”. If an image is purely decorative and does not add to the content, it should be marked as decorative or have a blank alt attribute (alt=””), indicating that it does not require a descriptive text.

Alt text is crucial for website accessibility. Its primary purpose is to describe the image for people who are visually impaired, allowing them to understand the page better by knowing what the picture represents. When writing alt text, it is important to be specific, keep the description under 125 characters, and avoid starting with phrases like picture of…” or Image of….

The Ally bulk alt text tool displays all a page’s images in an easy to use window where you can:

  • Mark images as decorative. This gives inserts a presentation role for the image, telling screen readers that they can skip the image and no alt text is required. 
  • Manually add alt text
  • Use AI to add alt text
    Note
    When you add alt text, it is usually added to the image metadata in the Media Library so it becomes part of the code.
     

How to use the bulk alt text tool

To use the bulk alt text tool:

  1. Scan the page for issues by clicking Scan URL.
    The Scan URL button starts scanning the page for accessibility issues.
    After scanning, the page opens with the Accessibility Assistant panel on the right side.
  2. Click the Alternative text issues box.
    The Alternative Text box shows you issues connected the image's alternative text.
  3. Click Bulk alt text to open the alt text tool.
    The Bulk alt text button opens a new window to add alt text
  4. Use the checkbox to mark decorative images.
    A checkmark is used to designate decorative images
  5. Use the text box to enter alt text manually.
    The text box to enter alt text manually
  6. Click the AI icon to have the AI generate alt text.
    The AI icon to have AI produce the alt text
    When done, click Apply to save the alt text.
    The Apply button finishes the bulk addition of alt text.
On this page

Share this article

Hosted with