logo
logo

Transformations

As a superuser, you can use transformations to manage the configuration of preset renditions and have these presets applied to renditions dynamically. Transformations allow you to provide users with renditions, in different dimensions, without the need to regenerate the public link.

The Media processing best practices provide guidelines for deciding which renditions to set according to your business needs.

The Transformations page lets you manage your transformations. To access the Transformation page:

  1. On the menu bar, click Manage .
  2. On the Manage page, click Transformations.

    A table lists the available transformations.

    Tip

    You can sort the transformations by name or modification date using the sorting buttons above the table. You can also search for the transformation you want using the search tile at the top of the page.

Transformations work as follows:

  • The system tries to apply a transformation on a file type and to convert it to the same file type (svg to svg, png to png, gif to gif).
  • If the system cannot do such a conversion, it returns the original file.

Add a transformation

To add a transformation:

  1. On the menu bar, click Manage .
  2. On the Manage page, click Transformations.
  3. On the Transformations page, on the top right, click + Transformation.
  4. On the Transformation dialog box, set the following settings.

    FieldTypeDescriptionValueMandatory?
    NameStringName of the transformation.String valueYes
    CropDrop-down listType of crop.None, Smart crop, or Crop to centerNo
    Width (px)Numerical valueThe transformation is scaled to this width depending on the selected Crop option.Numerical valueMandatory for Smart crop and Crop to center.
    Height (px)Numerical valueThe transformation is scaled to this height depending on the selected Crop option.Numerical valueMandatory for Smart crop and Crop to center.
    QualityDrop-down listQuality of the transformation.None, Maximum quality, High quality, Medium quality, or Low qualityNo
  5. Click Save.

Note

Width (px) and Height (px) parameters are not required for Crop type None, even if asterisks are visible.

Crop options

The following table describes the available crop options.

Crop OptionDescription
NoneNo crop
Smart cropSmart crop intelligently examines the content of an image and automatically focuses on the essential part of an image for cropping. This focus automatically searches the image for edges, skin tones, and areas of saturated color and attempts to position the crop box over the most significant feature.
Crop to centerCrop to center provides a rendition that you can resize with the aspect ratio unlocked. This option positions the crop box to the center of the image.

Dimensions

The dimensions of a transformation are defined by either the width or the height value that you input. The transformation image is scaled to this width or height depending on the selected crop option.

Note

Pay attention to the naming convention of the default transformations, as they might require editing if the height or width values are changed (e.g. w1200).

Edit a transformation

To edit a transformation:

  1. On the menu bar, click Manage .
  2. On the Manage page, click Transformations.
  3. Look for the transformation you want to edit in the table.
  4. On the transformation row, click Edit Transformation.
  5. Edit the parameters you want.
  6. Click Save.
Note

To delete a transformation, on the transformation row, click Delete .

Apply a transformation

To apply a transformation to an asset, you must append the transformation name to the URL of the public link as a query parameter named t. For example, to apply a transformation called NewTransformation to an asset, append the value &t=NewTransformation to the public link URL:

Can we improve this article ? Provide feedback