Image SEO — Alt & Title Generator for Magento 2

What you get

Key Features

Template-Based Alt & Title Generation

• Tokens — {{name}}, {{sku}}, {{store}}, {{category}} rendered per image in real time
• Filters — chain |truncate:N, |title, |lower, |upper, |strip, |default:'value' inside any token
• Separate templates — configure alt text and title text independently
• Graceful fallbacks — empty templates fall back to product name so no image ever renders with a blank alt attribute

Store View Aware

• Scope-respecting — every setting is configurable at default / website / store view level
• Multi-language stores — different alt text per store view for localized storefronts
• Multi-brand stores — different brand name in the alt text per website

Complete Surface Coverage

• Product detail page — main gallery image alt + caption + title
• Product gallery — fotorama / Hyva gallery captions with multi-image position suffix (— Image 2 of 5)
• Category grid tiles — alt text on every product card in category listings
• Related / upsell / cross-sell widgets — template applied to every widget image
• Search results — alt text on search result product thumbnails
• CMS product widgets — alt text on featured-product and new-arrival widgets

Safe Merchant Overrides

• Preserves merchant-authored labels — if a product has a custom image label set in admin, that takes precedence
• Replaces Magento defaults — the generic Image / main product photo / filename placeholders get upgraded automatically
• One config toggle — disable the gallery injection separately if you only want alt text on tiles, not captions

Performance Conscious

• Runs inline — no external API calls, no DB writes, pure template rendering
• Scope-cached config reads — uses Magento's cached scope config, zero DB overhead after warm-up
• Template caching — rendered alt text is cached alongside the native image block cache
• Zero JavaScript — fully server-side, no client-side rendering overhead

Clean & Extensible

• MEQP compliant — follows Adobe's Magento Extension Quality Program standards
• Pluggable vision adapter — VisionAdapterInterface lets you swap in OpenAI Vision / Claude Vision for AI-generated fallback alt text
• Optional Panth_ProductGallery wire — integrates automatically when the gallery module is installed
• Well-scoped plugins — four targeted plugins (ImageFactory, Helper\Image, Gallery, Uploader) rather than sweeping preferences

Token Reference

Every token is written as {{tokenName}} and can be combined with filters using |filterName:arg.

Unknown tokens render as empty strings, so a template like Brand: {{brand}} / {{name}} safely falls back to Brand: / Push It Messenger Bag if the brand token isn't wired up yet. Trailing separators are auto-cleaned.

Filter Reference

Filters are chained with | and run left-to-right.

Filters can be chained: {{name|lower|title|truncate:40}} is valid.

Template Examples

Basic name + store view

Alt: {{name}} - {{store}}
Title: {{name}}

Renders as:

Push It Messenger Bag - Luma Store View

Brand-suffixed with truncation (safe for long names)

Alt: {{name|truncate:80}} | Buy Online at {{store}}
Title: {{name}} — {{store}}

Category-scoped alt (when category context is available)

Alt: {{name}} in {{category|default:'our catalog'}}
Title: {{name}}

SKU-prefixed alt (useful for B2B catalogs)

Alt: [{{sku|upper}}] {{name}} | {{store}}
Title: {{name|truncate:60}}

Minimal SEO-only (category pages)

Alt: {{name}}
Title: {{name}}

Multi-store with localized brand in each alt

Configure Alt Text Template at the store-view scope:

• English store view: {{name}} | Premium Quality from {{store}}
• French store view: {{name}} | Qualité Premium - {{store}}
• Wholesale store view: [WHOLESALE] {{name}} - {{store}}

Coverage — Where Alt/Title Gets Injected

The module hooks every surface where Magento renders an <img> tag for a product:

This breadth matters because Magento 2 has four different code paths that eventually render a product <img>:

1. Magento\Catalog\Block\Product\ImageFactory::create — used by category grids, widgets, related/upsell/cross-sell
2. Magento\Catalog\Helper\Image::getLabel — used by some themes directly
3. Magento\Catalog\Block\Product\View\Gallery::getGalleryImagesJson — the product gallery JSON
4. Custom gallery blocks (Panth_ProductGallery, some premium themes)

Missing any one of these leaves a gap where alt text stays blank or reverts to the Magento default. Panth Image SEO plugs all four, so the rendered HTML across your entire storefront is uniformly template-driven.

Troubleshooting

Compatibility

Installation

Composer Installation (Recommended)

composer require mage2kishan/module-image-seo
bin/magento module:enable Panth_Core Panth_ImageSeo
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

Manual Installation via ZIP

1. Download the latest release ZIP from Packagist or the Adobe Commerce Marketplace
2. Extract the contents to app/code/Panth/ImageSeo/ in your Magento installation
3. Ensure Panth_Core is installed (required dependency)
4. Run the same commands as above starting from bin/magento module:enable

Verify Installation

bin/magento module:status Panth_ImageSeo
# Expected output: Module is enabled

Configuration

Navigate to Admin → Stores → Configuration → Panth Extensions → Image SEO to configure the module.

All four settings are scope-aware. Configure a shorter alt template on a mobile-focused store view, a different brand suffix on a wholesale store, or different language alt text per localized store — Magento's scope hierarchy handles the rest.

License

Panth Image SEO is licensed under a proprietary license — see LICENSE.txt. One license per Magento installation.