Skip to main content

Configure Image Source

In-depth guide about different configurations of image source.

Add Source#

Creating image source is first step towards delivering optmized images. Image source gives Gumlet information about how to fetch your original image and also allows different configuration options.

To create image source, visit Create Image Source page which should show below screen.

Create image source screen

Source Types#

You can select from different set of source types depending on how you are getting started with Gumlet. Each source types have different storage backends supported and at the end of source creation, you will get full guide on how to setup image delivery in most efficient way.

You can refer to our Original Media Storage guide to check supported storage backends.


Default Parameters#

Once you create an image source, you can also add default parameters. These are the parameters applied to all images from this image source even when you don't pass them via URL Query parameters.

Default parameters are overridden when the same parameter is supplied via the query parameter. For example, if you set width as default parameter with value 300, all images served will have a width of 300px by default now. If an image is requested with width=500 in the URL parameters, that image will be served with 500px width.

Error Image#

This image will be delivered when we can't fetch images from the origin. For example, when we get a 404 error from your origin server, users will see this image.

This can help maintain UI quality and show a placeholder image rather than a browser showing a broken image.

Origin Request Headers#

Set the custom headers you want to add when gumlet communicate with your origin server.

Gumlet Response Headers#

Set custom response headers you want to add when you get any response from Gumlet.


You can toggle the Canonical Link Header in gumlet response here.

CDN & Custom Domain#

A content delivery network (CDN) will be used by Gumlet to accelerate the delivery of your images and other static files. Free and Pro Plan users can choose Gumlet CDN, which has 8 Point of Presence (PoPs) worldwide. Business, Appsumo lifetime deal, and Enterprise users can choose AWS Cloudfront as a CDN option.

Go through this article for more information on custom domain.

Cache Management#

You can define browser cache time and CDN cache time for all of the images delivered through this Gumlet source.

This section also lets you purge cache for specific files. Please note that bulk cache clear is currently not supported but we are working to bring it soon. Meanwhile, if there is any custom cache clear needs, please contact support.