Audit Alt Text
wp_audit_alt_textAudit your WordPress media library to find images missing alt text. Scan in batches of up to 500 items, returning a paginated list of media IDs and titles for accessibility fixes.
Instructions
Scan the media library and report which IMAGE items are missing alt text. Skips non-image media (video/audio/file). Designed to be paginated for large libraries — start at offset 0, then re-run with the returned next_offset.
Args:
scan_limit (number): How many media items to scan in this call, 1-500. Default 100.
limit (number): How many missing-alt items to return in the result. Default 20.
offset (number): Pagination offset INTO THE MEDIA LIBRARY (not into the missing list). Default 0.
response_format (enum): markdown | json. Default 'markdown'.
Returns: WPAltTextAuditResult object with shape: { "total_media_scanned": number, "total_images_scanned": number, "missing_alt_count": number, "missing_alt_items": [ { "id": number, "title": string, "source_url": string, "attached_to_id": number } ], "has_more": boolean, "next_offset": number // Present if has_more }
Note: missing_alt_count is the count WITHIN this scan window only. Re-run with the returned next_offset to continue scanning the rest of the library.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum results to return (1-100). Default 20. | |
| offset | No | Number of results to skip for pagination. Default 0. | |
| scan_limit | No | How many media items to scan in this call (1-500). Default 100. | |
| response_format | No | Output format: 'markdown' for human-readable, 'json' for machine-readable. | markdown |