Resize, crop and format
Choose
gd or imagick with processing.native.driver. The default auto
prefers GD and uses ImageMagick when it can cover a format missing from GD.
JPEG orientation is normalized before resizing. Enable the formats you use in the selected server encoder.
An unavailable encoder reports a failed variant while successful variants remain
available. Source byte, pixel and estimated working-memory limits constrain
processing. Configure at most 16 native variants per source.
The recipe is saved with the source version when the job is scheduled. This keeps
an in-flight upload consistent with its configuration. Use a new name such as
card-v2 when you want a new output recipe. New settings apply to new uploads.
Existing outputs keep their recorded recipes until you explicitly regenerate them.
Keep or remove embedded metadata
Setstrip_metadata globally for Studio image conversions. It defaults to
true. Each named conversion can override it.
driver => 'auto', Studio
selects it when needed. An explicit GD configuration with
strip_metadata => false reports metadata_requires_imagick for that variant.
The original uploaded file retains its original bytes and metadata.
For optional video processing, use
processing.video.strip_metadata (default true). Setting it to false
maps the input’s supported container metadata to the generated playback file
and poster. Each output format determines which tags it supports.
Use different conversions for a model
Setprocessing.model_renditions in Laravel configuration. Each model’s list
replaces the global preset list for uploads associated with that model.
$post in your handler before calling the upload service.
The model class is saved with the source version, so a later Optimize image
uses that model’s current conversion configuration. Each queued job captures its
own preset snapshot.
Use a named variant in content
Store the asset ID, optional version ID and rendition name together. Resolve references through Studio to get the authenticated URL.rendition name in each reference.