Image renditions

  • Updated

You can set image renditions (based on size, crop and format) to automatically generate variations of images that are uploaded to the library. Image renditions provide access to images for your most common use cases, and eliminates time consuming manual edits. ​

When you view an asset in the Library, you can view linked related assets.

Set image renditions

  1. Go to your avatar > Asset Management.


  2. Click Add. The Add Rendition dialog box displays.


  3. Select your specifications and click Save. The Library view displays renditions on your new and existing assets. You can also view image renditions from the asset picker in a task.

Resize and crop image

To keep the original image size, disable Resize/Crop. Enable Resize/Crop to convert file formats and select the resample filter to be used. 

Keep Aspect Ratio

You can keep the aspect ratio of the image based on the number of pixels you specify, as shown in the following examples.

Width 1000 pixels


Height 1000 pixels


Resize & Crop

You can set both width and height to resize the image and crop it. 

Width 1080 x Height 1080


Resize to fit

You can set the container height and width to keep image aspect ratio of original image by adding white padding to fill the container size.

Width 1080 x Height 1080


Image formats

You can automatically convert image files to a specified format. Conversion options include:

  • Keep original – Retains the original files format.
  • JPG
    You can also set a quality level to help you reduce the file size of the resulting image. (You should specify 80% or above.)
  • PNG
  • WEBP


You can also choose which resampling filter you'd like to use for your resulting image. We'd recommend keeping this as default, but you can select the following filters:

  • Bi-linear
  • Bi-cubic
  • Nearest-Neighbor

These settings combine to create one pre-set.

View renditions

Click an asset in the library and open Related Assets to view variations of your image.


Use renditions

You can do the following with an image rendition:

  • Click Download (icon) to download it to your desktop. 
  • Open a preview and click Create Task from the image.
  • Select an image rendition from the Asset Picker from a task or from Optimizely Content Management System (CMS 12).