Image Optimisation for Magento 2

Generate modern image files for a Magento catalogue

Image Optimisation 1.0.4 creates WebP and, where supported by the installed image library, AVIF siblings for JPEG, PNG and GIF sources. It keeps each original and records observed generated sizes and status in an Admin image log. Imagick is selected when it supports the requested format; GD is the fallback. AVIF is off by default.

Choose when generation runs

• CLI: bin/magento agenticecom:image:scan registers existing catalogue gallery images as pending. bin/magento agenticecom:image:optimize --pending-only processes them; use --batch-size=N to limit a pending run. Without --pending-only, CLI scans supported images under Magento's media directory.
• Cron: processes up to 50 pending records every five minutes when Magento cron runs.
• Product image URL resolution: page-load mode generates missing siblings synchronously beside the original and resized cache files. Cron-only and CLI-only modes avoid that work in this hook.

Delivery requires integration: the product-image hook returns the original Magento URL. The package does not emit markup or swap GraphQL image URLs. Configure your Luma theme, Astro storefront or image delivery layer to select and serve the generated files. Test browser requests, fallbacks and caching.

Optional image handling

An upload hook can downscale oversized JPEG/PNG files when enabled; it changes the saved upload and is off by default. A response hook can add loading="lazy" to eligible HTML image tags after a configured count, excluding chosen CSS classes. It is also off by default. HTML order does not identify the visual above-the-fold image.

The generator checks source MIME type, byte size (30 MB), side length (12,000 px) and pixel count (50 million) before decoding. Generated files may be larger than originals, so no fixed compression saving is promised. Image codec availability and quality vary by host.

Version 1.0.3 and compatibility

The exact 1.0.2 ZIP was installed through Composer, upgraded and DI compiled on Magento Open Source 2.4.9 / PHP 8.5.10. A controlled WebP conversion and Luma page were tested. It fixes the PHP 8.5 GD cleanup failure found in 1.0.1 and removes inactive Admin controls that previously implied CMS, retina and folder-exclusion features. Other editions, versions, themes and encoder combinations need staging qualification.

Read the Image Optimisation user guide for setup, delivery requirements and CLI modes.

Purchase and support

A one-time purchase includes 12 months of updates and support. Renewal is optional and never billed automatically. Eligible standalone extensions may renew at 60% of the then-current regular list price before term end or within 30 days afterward, plus applicable tax. Purchased versions remain usable afterward. See the AgenticEcom licence and your order terms. Support: support@agenticecom.net.

Frequently asked questions

Will browsers automatically receive WebP or AVIF?

No. This package writes alternate files but returns the original Magento image URL. A theme or delivery layer must select the alternates.

Can conversion affect a shopper request?

Yes, page-load generation is synchronous. Choose cron or CLI mode to move bulk work away from page rendering.

Are CMS-specific and retina variants generated?

No. Inactive Admin controls suggesting those paths were removed in 1.0.2. The full CLI can scan supported images under pub/media, but no CMS-specific or retina delivery workflow is included.