Skip to main content
Did you know? Roughly 4,000 digital accessibility lawsuits were filed in US courts in 2024 (UsableNet). See what a free scan finds on your site →
Accessibility Shield
FeaturesFree ScannerFree ToolsPricingFAQBlogContact
Fix guides / Images missing alt text / WordPress

Add alt text to images in WordPress

Add it once in the Media Library, and check images already placed in posts.

Checked against WordPress's help docs on 2026-10-09. Menu names can change; the source links below have the latest steps.

  1. Go to Media > Library and click an image.
  2. Fill in Alternative Text with a short description. Leave it empty only for purely decorative images.
  3. Images already placed in a post or page keep the alt text they had when inserted. Open the post, select the image block, and fill in Alternative text in the block settings sidebar.
  4. For WooCommerce product images, set alt text on each image in the Media Library (or from the product's image picker).
  5. Theme or page-builder images (logos, hero images) may have their own alt field in the theme options or the builder's image widget.

Check it: publish your change, then run a new scan from your dashboard. The issue should drop off the list.

What this issue means and who it affects

Sources

  • WordPress Accessibility Handbook: alt text(opens in a new tab)
  • Learn WordPress: using the Media Library(opens in a new tab)
  • W3C alt text decision tree(opens in a new tab)

Not sure which of these your site has?

Run a free scan. It lists the issues on your page and links each one to the right guide for your platform.

Scan My Website Free
Accessibility Shield

Continuous automated WCAG 2.1 AA audits, hosted accessibility statements, and on-site barrier reporting for modern web teams.

Footer Navigation

Product

  • Automated Audits
  • Pricing & Plans
  • Free Audit Scanner
  • No-Code Fix Guides
  • Contrast Checker
  • Statement Generator
  • Compliance Guides

Trust & Security

  • About Our Mission
  • Security Architecture
  • Accessibility Statement
  • Contact Support

Legal & Policies

  • Privacy Policy
  • Cookie Policy
  • Terms of Service
  • 14-Day Refund Guarantee
© 2026 Accessibility Shield. All rights reserved.·Zero-Tracking Platform · No cookies sold or tracked
Theme