Transloadit

What is an Image Derivative?

An image derivative is a generated version of a source image with changed dimensions, format, crop, quality, effects, or other properties. It remains associated with the source while serving a distinct delivery or presentation need.

How Image Derivatives work

A derivative is best treated as a reproducible asset whose identity includes its master, transformation recipe, processor version, and output settings. It may be materialized in storage or generated on demand and cached near viewers. Digital asset systems use this relationship to deliver crops, previews, print renditions, and device-specific variants without modifying the master. Lifecycle rules must connect replacement or deletion of the source to every dependent rendition.

Key facts

  1. A cache key that omits crop coordinates, orientation handling, color profile, or encoder version can serve a technically valid but incorrect prior rendition.
  2. Derivatives should normally be generated from the highest-quality master, because chaining one resized or lossy rendition into another accumulates avoidable damage.
  3. A focal point or safe-area instruction is source metadata, while the resulting crop is a derivative; keeping them separate permits new sizes without manual recropping.

When Image Derivatives matter

Generate named derivatives for stable requirements such as thumbnails, previews, and responsive breakpoints instead of transforming each request arbitrarily. When the source changes, invalidate or regenerate its derivatives to prevent stale output.

Turn media knowledge into a working pipeline

Connect uploads, processing, AI, storage, and delivery through one declarative API — with the encoding stack, scaling, and format churn handled for you.

Try Transloadit for free