README

Magento 2 Image SEO Extension: Auto Alt Text and Title for Product Images (Hyva + Luma)

Auto-generate SEO alt and title attributes for every product image across your entire Magento 2 catalog. One template, configurable per store view, applied to category grids, product galleries, related products, upsells, cross-sells, widgets, and search results.

Product page: kishansavaliya.com/magento-2-image-seo.html

Quick Answer

What is Panth Image SEO? It is a Magento 2 image SEO extension that auto-generates alt and title attributes for every product image from merchant-controlled templates with tokens like {{name}}, {{sku}}, {{store}}, and {{category}}.

What does it add to my store?

• Template-based alt text so every product image gets a descriptive, keyword-rich alt attribute instead of a blank or generic one.
• Template-based title text with a separate template so you can keep titles short while alt attributes carry full SEO copy.
• Token and filter system including truncate, title-case, upper, lower, strip, and default fallback.
• Store view scope so each language or brand store view can have its own alt text templates.
• Gallery injection to push alt/title into the product gallery JSON used by fotorama and Hyva gallery widgets.

Which themes are supported? Both Hyva (Alpine.js) and Luma. The module hooks into Magento's standard image rendering paths so it works on both without theme-specific code.

What does it need? Magento 2.4.4 to 2.4.8, PHP 8.1 to 8.4, and the free mage2kishan/module-core package.

Need Custom Magento 2 Development?

Get a free quote for your project in 24 hours for custom modules, Hyva themes, performance work, M1 to M2 migrations, and Adobe Commerce Cloud.

Visit our website: kishansavaliya.com  |  Get a quote: kishansavaliya.com/get-quote

Table of Contents

• Who Is It For
• Key Features
• Compatibility
• Installation
• Configuration
• How It Works
• Token Reference
• Filter Reference
• Template Examples
• Coverage - Where Alt/Title Gets Injected
• Screenshots
• FAQ
• Support
• About Panth Infotech
• Quick Links

Who Is It For

• Stores with large catalogs where writing alt text manually for hundreds or thousands of product images is not practical.
• Merchants focused on image search traffic who want product photos to appear in Google Images with proper alt attributes.
• Hyva storefronts that need gallery alt/title injected into the Alpine.js gallery JSON without custom theme code.
• Multi-store and multi-language setups where each store view needs different alt text copy or a different brand suffix.
• Merchants facing accessibility audits where blank or generic alt attributes on product images are flagged.

Key Features

Template-Based Alt and 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, or 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 and title.
• Product gallery - fotorama and Hyva gallery captions with multi-image position suffix.
• Category grid tiles - alt text on every product card in category listings.
• Related, upsell, and 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 label takes precedence.
• Replaces Magento defaults - the generic Image, main product photo, or filename placeholders get upgraded automatically.
• One config toggle - disable 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.
• Zero JavaScript - fully server-side, no client-side rendering overhead.

Clean and Extensible

• MEQP compliant - follows Adobe's Magento Extension Quality Program standards.
• Pluggable vision adapter - VisionAdapterInterface lets you swap in an AI vision provider 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.

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 from Packagist or from the product page.
2. Extract it to app/code/Panth/ImageSeo/ in your Magento install.
3. Make sure Panth_Core is installed too (required dependency).
4. Run the commands above starting from bin/magento module:enable.

Verify Installation

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

After install, open:

Admin → Stores → Configuration → Panth Extensions → Image SEO

Configuration

Go to Stores → Configuration → Panth Extensions → Image SEO.

All four settings are scope-aware (default / website / store view). Configure a different alt template per store view, a shorter title on a mobile-focused store, or localized copy for each language store.

How It Works

1. The module installs four targeted plugins on Magento's image rendering paths.
2. When a product image is rendered, the active plugin checks the master toggle and reads the configured alt/title templates from scope config.
3. Tokens in the template are resolved: {{name}} becomes the product name, {{sku}} becomes the SKU, {{store}} becomes the current store view name, {{category}} becomes the current category name when available.
4. Filters are applied left to right: {{name|lower|title|truncate:60}} clips the title-cased product name at 60 characters.
5. If a product already has a custom merchant-authored image label, that label is kept as-is. Only Magento's default placeholder values are replaced.
6. The rendered alt and title text is injected into the image tag or gallery JSON before the response is sent to the browser.

Token Reference

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

Unknown tokens render as empty strings and trailing separators are auto-cleaned, so a template like {{name}} - {{category}} safely degrades to Push It Messenger Bag when category context is not available.

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 and store view

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

Renders as: Push It Messenger Bag - Luma Store View

With truncation for long product names

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

Category-scoped alt

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

SKU-prefixed alt for B2B catalogs

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

Minimal SEO-only

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

Multi-store with localized copy

Configure Alt Text Template at the store-view scope:

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

Coverage - Where Alt/Title Gets Injected

The module hooks every surface where Magento renders a product image tag:

Screenshots

Admin Configuration - Stores → Configuration → Panth Extensions → Image SEO

The admin UI exposes every setting at store-view scope: master toggle, alt template, title template, and gallery-injection toggle. Token and filter reference is inlined under each field.

Before / After - What Changes on Your Storefront

Before: <img alt=""> or <img alt="Image"> - invisible to image search, fails accessibility audits. After: <img alt="Premium Leather Bag - Luma Store View"> - indexed, accessible, on-brand across every store view.

FAQ

Does this work on Hyva themes?

Yes. The module injects into getGalleryImagesJson, which Hyva reads for its Alpine.js gallery. Category tile alt attributes go through ImageFactory, which Hyva's product/list.phtml also uses. No jQuery or RequireJS needed.

Does it work with Luma?

Yes. Luma's fotorama gallery reads from the same caption field in the gallery JSON, and Luma's category grid uses the same ImageFactory path.

Will it overwrite my custom image labels?

No. If a product has a custom image label set in admin (anything other than empty, Image, main product photo, or the raw filename), that label is preserved. Only Magento's default placeholder values are replaced.

Will it slow down my storefront?

No. The module runs inline with no external API calls, no database writes, and no JavaScript. Config reads go through Magento's cached scope config so there is no extra DB overhead after warm-up.

Can I use different alt text on different store views?

Yes. All four settings respect Magento's standard scope hierarchy (default, website, store view). Set a different template at the store-view scope and the plugins honor it automatically.

Can I disable only the gallery injection?

Yes. Set Apply to Gallery Images JSON to No. The master toggle stays on so category tiles and widgets still get template alt, but the gallery JSON is left untouched.

Is it compatible with Varnish and Redis FPC?

Yes. The module does not cache anything itself. It relies on Magento's native block cache and FPC. Template rendering is idempotent so cache hit rate is unaffected.

Does it touch the database?

No. The module is pure template rendering with no DB tables and no writes. All state lives in Magento's cached scope config.

Does Panth Image SEO need Panth Core?

Yes. mage2kishan/module-core is a required dependency. Composer installs it automatically. It provides the admin tab layout and common utilities used across the extension suite.

Support

Response time: 1-2 business days.

Need Custom Magento Development?

Looking for custom Magento module development, Hyva theme work, store migrations, or performance tuning? Get a free quote in 24 hours:

About Panth Infotech

Built and maintained by Kishan Savaliya (kishansavaliya.com), a Top Rated Plus Magento developer on Upwork with 10+ years of eCommerce experience.

Panth Infotech is a Magento 2 development agency that builds high quality, security focused extensions and themes for both Hyva and Luma storefronts. The extension suite covers SEO, performance, checkout, product presentation, customer engagement, and store management, with each module built to MEQP standards and tested across Magento 2.4.4 to 2.4.8.

Browse the full extension catalog on our Magento extensions page or on Packagist.

Quick Links

Ready to fix your image SEO across the entire catalog?

SEO Keywords: magento 2 image seo, magento 2 image alt text, magento 2 alt attribute, magento 2 image title, magento 2 product image seo, magento 2 seo extension, magento 2 image optimization, magento 2 auto alt text, magento 2 bulk alt text, magento 2 image alt generator, magento 2 seo alt tags, magento 2 category image seo, magento 2 gallery alt text, magento 2 widget image alt, magento 2 wcag compliance, magento 2 accessibility alt, hyva image seo, hyva alt text, hyva image optimization, luma image seo, luma alt text, magento 2 image search seo, magento 2 google images, magento 2 multi-store alt text, magento 2 localized alt text, magento 2 alt template, magento 2 alt tokens, magento 2 image label extension, mage2kishan image seo, panth infotech image seo, kishan savaliya magento, magento 2.4.8 image seo, magento 2 php 8.4 image seo, hire magento developer upwork, top rated plus magento freelancer, custom magento development, adobe commerce image seo, magento 2 alt automation, magento 2 bulk image optimization