Image Transformations

URL-based parameters to transform images in real-time.

URL Based transformations can perform real-time transformations to deliver perfect images to the end-users. These transformations can be performed by using the URL-based transformation parameters.

URL structure
URL structure
URL-endpoint transformation image path

These transformation parameters w-300,h-300 can be added in the URL as path params or as query parameters.

Images over 40MB in size will not be transformed.

Use cases:

The transformations can be as basic as manipulating the height and width of the image, to complex transformations like watermarking or smart cropping of your images. A few common use-cases are explained below.

1. Creating multiple variants from a single master image

Often you need multiple variations of a single image to cater to different devices and sections within your application layout. Now you can create as many as variations using real-time image transformation parameters. Just change the URL to get a new image.

Learn about all commonly used resizing parameters

Learn how to used named transformations for better code readability

2. Low-quality image placeholder

You can load a small size blurred image as a placeholder while the actual image loads in the background. provides a blur parameter bl that can give you a blurred file that is smaller in file size but can be used as a placeholder as it shows the content. This technique is used by many applications, including Medium publication.

3. Deliver Responsive and Art Directed Images

With the ability to resize images by changing URL, it becomes very easy to implement responsive images in your web applications. Learn more from these detailed guides:

4. Smart-cropping for generating meaningful thumbnails can automatically detect the most important part of the image and preserves it in the output thumbnail. This could be super useful while creating small thumbnails. Learn more from the blog post below.

5. Watermarking or image overlay

You can overlay multiple images or colored rectangles on your original image directly from the URL. If you happen to change the overlay image, it can be done in minutes instead of days.

Here we have put the logo ( on another image using overlay parameter i.e., oi

Learn more about image overlay,oi-logo-white_SJwqB4Nfe.png/medium_cafe_B1iTdD0C.jpg

6. Text overlay

You can overlay text on an image and create dynamic banners. You can also control the font, font size, weight, color, and position of the text.

Learn more about text overlay,ots-45,otc-00FFFF/medium_cafe_B1iTdD0C.jpg