Setup Image Source

Provide original image location to Gumlet and setup default parameters.

Gumlet does not provide an image storage facility. You can store your original images on the 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 the "+ Add Source" button to get to the below screen.

Gumlet source creation screen

Source Types

Gumlet supports the following different media storages as sources. You can select any of them while creating a source and provide appropriate credentials.

  • Web Folders

  • Web Proxy

  • Amazon S3

  • Google Cloud Storage

  • DigitalOcean Spaces

  • Wasabi Storage

  • Cloudinary

In most cases, Web Folder is the right choice of source type.

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

Choose CDN & Subdomain

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.

You are required to add the Gumlet subdomain through which you want to deliver your images. For example, if your website name is "example.com", you can choose example.gumlet.net or example.gumlet.io as a subdomain for serving images. Kindly note that the choice of subdomain does not have any impact on SEO or performance.

Create Gumlet Subdomain for image delivery

To create a Subdomain (+ free SSL) to improve your branding and SEO, please refer to our Custom domain (CNAME+SSL) guide.

Step 2: Parameters

Default Parameters

While creating 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 "Get" parameters.

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

If default parameters are applied to your image, an extra headerx-gumlet-defaultparamsis added to the images' responses. 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 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.

Source Default Parameters