Setup Image Source

Provide original image location to Gumlet and setup default parameters.

Gumlet does not provide image storage facility. You can store your original images on storage of your choice and retain full control over them. Gumlet does not modify your original images. You can always go back to serving current images.

Step 1: Add Source

Sign Up or Login to your Gumlet account and click "+ Add Source" button to get to the below screen.

Add Source Screen

Source Types

Gumlet supports following different media storage as source. You can select any of them while crearting source and provide appropriate credentials.

  • Web Folders

  • Web Proxy

  • Amazon S3

  • Google Cloud Storage

  • DigitalOcean Spaces

  • Wasabi Storage

  • Cloudinary

You can read more about these storage systems and how to configure them on our help page about storage systems.

Choose Subdomain

You are required to add Gumlet subdomain through which you want to deliver your images. For example, if your website name is, you can choose as subdomain for serving images.

Subdomain Entry Section

Step 2: Parameters

Default Parameters

While creating image source, you can also add default parameters. These are the parameters which will be applied to all images from this image source even when you don't pass them via URL parameters.

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

If default parameters are applied on your image, an extra header x-gumlet-defaultparams is added in response of all images. This will help you identify which default params are applied and debug issues in image delivery.

Error Image

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

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

Source Parameters