gumlet / module-image
Magento 2 module to append width (w) parameters to product and media image URLs for optimized image delivery.
Installs: 0
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
Type:magento2-module
Requires
- php: >=7.1.0
- magento/framework: >=102.0.0
This package is auto-updated.
Last update: 2025-07-22 13:57:43 UTC
README
Automatically optimize images in Magento using Gumlet CDN.
Features
- Appends
w
(width) parameter to all product and media image URLs - Works with product images, CMS, email, and widget images
- Uses theme configuration for width detection
- Prevents duplicate URL processing
Installation
Composer (Recommended)
composer require gumlet/module-image
Manual
- Copy the
Image
folder toapp/code/Gumlet/
in your Magento installation. - Run:
bin/magento setup:upgrade bin/magento cache:flush
Usage
No manual configuration required. All product and media images will automatically have a w
parameter appended.
Configuration
- Width is determined from the theme's
view.xml
or block context. - No admin configuration required.
Compatibility
- Magento 2.3 and above
Changing Secure Base URL for Media to Gumlet
To deliver all Magento media assets (images, etc.) via Gumlet, update your secure base media URL:
- Login to Magento Admin
- Go to Stores > Configuration > General > Web
- Expand the Base URLs (Secure) section
- Find Base URL for User Media Files
- Change the value from:
to your Gumlet media URL, e.g.:{{secure_base_url}}media/
https://your-gumlet-domain.gumlet.io/media/
- Click Save Config
- Flush cache:
bin/magento cache:flush
Note:
- This will route all media requests through Gumlet. Make sure your Gumlet origin is set to your Magento media directory.
- If you want to revert, simply change the value back to
{{secure_base_url}}media/
.
Support
For issues, please open an issue on the repository or contact Gumlet support.
License
MIT