Knowledge Base

Create smaller versions of assets (derivatives)

A derivative is a file that is based on another source, for example, a low-resolution representation of a print-quality photo. During the upload process, Bynder can automatically create pre-defined image derivatives with different dimensions, quality, and format. Bynder can either maintain the original aspect ratio of an image, or crop or pad an image to fit the specified dimensions. We can create smaller versions of your original image asset in both a JPG and PNG file extension. However, the resolution of derivatives can't be larger than the original file.

If derivatives are automatically created for you, you do not have to manually download assets and resize them.

If you want your derivatives to be automatically generated, contact your Customer Success Manager. We can also create derivatives of video files.

If the resolution of your original images is sufficient, Bynder creates the following default derivatives:

  • mini: 80x80 pixels
  • thul: 250x250 pixels
  • webimage: 800x600 pixels

The resolution of your default derivatives may deviate slightly from the dimensions mentioned above depending on the aspect ratio of your original images.

The default derivatives are only returned via the API and are not available for download in the asset detail view.

If you are new to the concept of image derivatives, and want to explore it more, see Get started with image derivatives.

Custom derivatives

We can set custom resolution for your derivatives. When creating a derivative with custom resolution, Bynder uses the longer side to create the derivative. If your image is, for example 800 by 600 pixels, the 800 pixels side is used for resizing. The 600 pixels side is scaled according to the aspect ratio.

In addition to custom file dimensions, we can also set up a custom DPI value for your derivatives. For instance, we can automatically generate a 300 DPI derivative of your original 600 DPI image file.

If you don't want your files to be resized according to the aspect ratio we can enable an automatic crop for you. When cropping we can use the exact custom resolution. The derivative is then created from the center point of the image. Alternatively, if you edit an asset and set a focus point, the derivative for this asset is automatically adjusted to be cropped and resized from the focus point.

If you need images that have default dimensions and the aspect ratio preserved to use in your webshop, we can resize the image according to the longer side and aspect ratio, and the remaining canvas size will be filled with a blank space to meet your fixed dimensions.

We can customize the derivatives to be created in specific output formats only (JPG, PNG, or both), to be created for the assets with specific regular expressions, to be publicly available, to be created for assets that are in specific formats (for example, for JPG assets only), or to be generated in a one of the three color models (RGB/CMYK/inherit).

PNG derivatives can also be customized to preserve transparency, and for JPGs we can define the desired quality.

We can also create a unique URL for each derivative.

Video derivatives

We support the following derivatives:

  • MP4, TS or WebM as container / extension / type
  • H264 or VP8 as video codec
  • AAC or Ogg Vorbis as audio codec

We can customize the bitrate, frame rate, resolution, sample rate, frames between keyframes, number of reference frames, profile and level. Video derivatives can be made publicly available.

Document derivatives

We can convert the original DoC, DOCX, PPT and PPTX document and offer it as a PDF derivative.

Manual derivatives

In some cases you may want to customize your files in a more advanced way using your preferred software, such as converting your image to grayscale. The manual derivative feature allows you make the customizations outside of Bynder and to then easily upload it back to Bynder as manual derivative. Read more about it here.

Watermarked derivatives

Are you using your derivatives on external websites and do you want to protect your assets? Apply a watermark to your derivatives to make sure you can always recognize your assets and reduce the risk of them being misused. Read more about it here.

Best practices for derivatives

To enable the derivatives for you, we need to know the resolution you require. Normally, we advise the image derivatives to be the following:

  • Original
  • Large (JPG - 1024*786 - 300 DPI - RGB)
  • Small (JPG - 640*480 - 72 DPI - RGB)

For videos, we recommend the following:

  • Original
  • Large (MP4 at 1920 x1080)

Read more about all the supported output file formats we offer for conversion here.

Download derivatives

Derivatives are available on the Asset Detail page. You can download derivatives and the original if you click Download all files. You can also have the a preselect option enabled. In this case, you can select which derivatives you want to download. The Original will always be on top of the list, and the sequence in which other derivatives display can be customized.

  • download preselect popupdownload preselect popup

You can click the ? to open a details table showing which assets have which derivatives available to be downloaded. If the table displays two derivaties with identical names, one is a PNG and the other a JPG derivative.

Use case

You might want to use derivatives to protect your source files. For example, you can make the Original files not downloadable for light users and allow light users to download derivatives or web versions only.

Enable the Download web versions permission for light users so that they can only download derivatives whose resolution is below 800x600 px.

Learn more