Image renditions

  • Updated

You can set image renditions (based on size, crop, and format) to automatically generate variations of images that you upload to the library. Image renditions provide access to images for your most common use cases and eliminate 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. 

    Image-rendition-2.png

  2. In the Renditions section, click Add. The Add Rendition dialog box displays.
  3. To keep the original image size, toggle off Resize/Crop. Toggle on Resize/Crop to convert file formats and select the resample filter. 

    Image-rendition-focal-point-1.png

  4. Select your specifications and click Save.

    You can view renditions in the following places:

    • The Library view displays renditions on your assets. Select an image to see the asset attributes. You can also view image renditions from the asset picker in a task.

      renditions-2.png

    • In Related Assets, when you are editing an image.

      renditions.png

Keep aspect ratio

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

Width 1000 pixels

Image-keep-aspect-ratio-1.png

The following image shows how Keep aspect ratio works with a Width of 1000:

image-keep-aspect-ratio-result.png

The following image shows how Keep aspect ratio works with a Height of 1000:

image-keep-aspect-ratio-result-2.png

Resize/Crop

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

Resize-crop.png

The following image shows how Resize/Crop works with Width 1080 and Height 1080:

Image-resize-and-crop-2.png

Automatic smart focal point

Smart-focus.png

Enable Smart Focal Point to use AI to detect an image's subject automatically. This option centers the crop around what it detects as the image's important part. Crops that do not use Smart Focal Point use the center of the image.

Manual smart focal point

You can specify where you want the focal point to be in an image.

  1. From the asset's options menu (...), select Adjust Focal Point.

    Adjust-focal-point-1.png

  2. Move the focal point (purple circle) to the preferred position and click Save.
    When choosing a focal point, crop renditions use the new one.

    Adjust-focal-point-2.png

  3. Select the asset in the library and open Related Assets to view the image rendition.

    Adjust-focal-point-3.png

    The 700px X 700px image rendition shows the focal point in the center.

    Adjust-focal-point-4.png

Resize to fit

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

Image-resize-to-fit-1.png

The following image shows how Resize to Fit works with a  Width of 1080 and Height of 1080

Image-resize-to-fit-2.png

Image formats

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

  • Keep original – Retains the original file's 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

Resampling

You can also choose which resampling filter you'd like to use for your resulting image. You should accept the default, but you can select the following filters:

  • Bilinear
  • Bicubic
  • 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.

Image-rendition-8.png

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 or Optimizely Content Management System (CMS 12) from a task.

Image-rendition-9.png