Integration steps

Gumlet offers a straightforward integration to optimize all the images on your Magento website. Here is what you need to do:

Step 1: Configure source in Gumlet dashboard

Configure origin based on where your images are stored. You can check the guide here: Setup Image Source

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://{{your_subdomain}}

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://{{your_subdomain}} 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://{{your_subdomain}}

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

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.