README

Alt Extend

A Craft CMS 5 plugin that automatically extends image alt attributes with a configurable text — as suffix or prefix — keeping your SEO and accessibility consistent across the entire site.

Why?

Many websites need a recurring brand name or location appended to every image alt text. Doing this manually across hundreds of images is tedious and error-prone. Alt Extend handles it globally through a single Twig filter while still allowing you to opt out on individual assets.

Requirements

• Craft CMS 5.3.0+
• PHP 8.2+

Installation

composer require projectjoker/craft-alt-extend
php craft plugin/install alt-extend

Or install through the Craft Control Panel under Settings > Plugins.

Configuration

Open Settings > Plugins > Alt Extend in the Control Panel:

Example output

With the text set to My Company and the default separator:

Usage

Pass an asset directly to the alt filter. The filter reads the native alt text from the asset:

<img src="{{ image.url }}" alt="{{ image | alt }}">

Plain strings work as well:

<img src="{{ image.url }}" alt="{{ 'Product photo' | alt }}">

Per-asset opt-out

During installation the plugin creates a Lightswitch field called Disable Alt Extend (handle: altExtendDisabled). Add this field to your asset volume's field layout to gain per-image control.

When the switch is enabled on an asset, the alt filter returns the original alt text without any additions.

Roadmap

• Multi-site / multi-language support
• Configurable field handle for the opt-out switch

License

This plugin is licensed under the MIT License.

Built by Project Joker