Gumlet's no-code integration guide for Magento 2.x

With this simple no-code integration guide, you would be able to serve optimized images via Gumlet that are,

  • Compressed without any loss in perceptual quality

  • Converted to WebP on supported platforms

  • Delivered via a superfast CDN

Step 1: Configure image source

Sign Up with Gumlet and follow this simple guide to set up an image source with Gumlet. It tells us where to fetch you original images and optimize them. Kindly note that your original images would not be modified by Gumlet.

Step 2: Fetch image through Gumlet endpoint

Let's fetch image from Gumlet endpoint to check if everything is working fine.

If your old URL was, then new URL should be served from https://{{}}/media/catalog/product/p/p/example.jpg?w=500

If above URL works fine, please go ahead with Step 3.

Unable to fetch image?

Contact if you are not able to fetch the image as explained above. In such a situation, do not move to step 3 as this could break your website images.

Step 3: Replace the base URL for user media files in Magento

Once the above image works with the Gumlet URL endpoint, you will need to make changes within the Magento admin panel to switch the image delivery and optimization to Gumlet.

In Magento 2, go to Stores ▶️ Configurations ▶️ Web:

Fill Base URL for User Media Files with the https://{{}}/media. Note that we added /media in the end.

  1. Save these settings.

  2. Use the sidebar to navigate to System ➡ Cache Management and Flush Magento Cache.

  3. Refresh the webpage of your Magento storefront, and you should see images loading via Gumlet


If you set up Magento as per the docs, and you see /pub/ in your image URLs, then, in this case, change the value of Base URL for User Media Files in the Magento admin panel to https://{{}}/pub/media

Using Gumlet to deliver non-image static assets like JS or CSS via CDN

You can also use Gumlet to deliver non-image type static assets like JS, CSS, or font files. Navigate to Stores ▶️ Configurations ▶️ Web:

  1. For Base URL for Static View Files, set https://{{your_subdomain}} or https://{{your_subdomain}} depending on your setup.

You have successfully integrated your Magento storefront with Gumlet and all your images, moving forward, will be optimized and delivered in the right format.