jainilnagar/alt-scout

A lightweight Craft CMS plugin that helps editors find image assets missing native alternative text.

1.0.0 2026-06-02 04:34 UTC

Requires

• php: ^8.0.2
• craftcms/cms: ^4.0.0 || ^5.0.0

Requires (Dev)

• craftcms/ecs: dev-main
• craftcms/phpstan: dev-main

MIT

• Jainil Nagar

• assets
• Audit
• images
• accessibility
• Craft
• craftcms
• alt text

Published on Packagist.org on 2026-06-02 04:46 UTC

README

Alt Scout for Craft CMS

A lightweight accessibility audit helper for finding Craft image assets missing native alternative text.

Features

• Control panel section: Alt Scout
• Lists image assets with empty native alt text
• Filter by asset volume
• Export missing-alt assets as CSV
• Dashboard widget with missing-alt count
• Setup guidance when native Alternative Text is not visible/configured
• No third-party API, no heavy queues, no external services

Requirements

• Craft CMS 4.x or 5.x
• PHP 8.0.2+

Installation

You can install Alt Scout via the plugin store, or through Composer.

Composer

You can also add the package to your project using Composer and the command line.

1. Open your terminal and go to your Craft project:

    cd /path/to/project
   

2. Then tell Composer to require the plugin, and Craft to install it:

    composer require jainilnagar/alt-scout && php craft plugin/install alt-scout
   

Craft Plugin Store

To install Alt Scout, navigate to the Plugin Store section of your Craft control panel, search for Alt Scout.

Usage

Go to Alt Scout in the Craft control panel.

The plugin scans image assets where Craft's native alt value is empty. You can filter by volume and export the result as CSV.

Important: enable Craft's native Alternative Text field

Alt Scout checks Craft's native asset alt value.

If you do not see an Alternative Text input when editing assets, add it to each asset volume field layout:

Settings → Assets → Volumes → Your Volume → Field Layout

Then drag Craft's native Alternative Text field into the layout and save.

Development checks

composer check-cs
composer fix-cs
composer phpstan
composer analyse

Roadmap ideas

• Asset index source/filter integration
• Optional warnings on asset edit screens
• Custom alt quality rules such as minimum length or filename-like alt text
• Support for reporting custom legacy alt fields before migration

License

MIT