Skip to content

Z403: MISSING_ALT

  • Severity: Error


    Penalty: 0.0 points | Category: general

  • Remediation & Opt-In


    Auto-Fixable: No | Opt-In: No


Rationale

This accessibility rule is triggered when an HTML or Markdown image tag (such as ![](image.png) or <img src="...">) lacks descriptive alternative text (alt). Accessible image captions are required for screen readers.


How to Fix

Inspect the flagged location in the Markdown file and update the content or configuration:

  • Failing Pattern (Triggers Z403)


    docs/example.md
    <!-- BAD: Image tag without alternative text description -->
    !\[\](../assets/diagram.png)
    
  • Passing Pattern (Resolves Z403)


    docs/example.md
    <!-- GOOD: Image tag with clear alternative text -->
    ![System Architecture Diagram](../assets/diagram.png)
    

Configuration

.zenzic.toml
# Audited across all Markdown image tags

Reference

See the Finding Codes Index for finding code details.