# projects / craft cms / alt-scout

Alt Scout

Craft CMS · v1.0.0 · View on GitHub →

Alt Scout is a lightweight Craft CMS plugin that helps editors find image assets missing native alternative text — a small but meaningful accessibility win. No third-party API, no heavy queues, no external services.

Requirements

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

Installation

Install from the Craft Plugin Store (search for Alt Scout), or via Composer:

cd /path/to/project
composer require jainilnagar/alt-scout && php craft plugin/install alt-scout

Features

  • A dedicated Alt Scout control panel section listing image assets with empty native alt text.
  • Filter by asset volume and export missing-alt assets as CSV.
  • A dashboard widget showing the missing-alt count.
  • Setup guidance when the native Alternative Text field isn’t configured yet.

Usage

Open Alt Scout in the Craft control panel. It scans image assets where Craft’s native alt value is empty; you can filter by volume and export the results as CSV.

Enable Craft’s native Alternative Text field

Alt Scout reads Craft’s native asset alt value. If you don’t see an Alternative Text input when editing assets, add it to each volume’s field layout:

Settings → Assets → Volumes → Your Volume → Field Layout

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

Roadmap

Planned ideas include asset index source/filter integration, optional warnings on asset edit screens, custom alt-quality rules (minimum length, filename-like detection), and reporting legacy alt fields before migration.

License

MIT.

← all projects source on GitHub →