Keep or remove the uploaded original
keep to false to retire native image originals after all conversions are
ready. Studio first publishes the selected optimized conversion as a NEW source
version, preserves its thumbnail/preview mappings and updates the filename and
MIME type. It never changes the bytes behind an existing version identifier.
Failed or missing conversions prevent retirement. Documents, videos and Spatie
or other externally owned originals are not deleted by this policy.
The original remains temporarily available during the configured grace period
(minimum one hour). Run the following command manually or through your scheduler:
keep back to true stops subsequent original deletion;
it cannot restore files already deleted. The optimized master remains available
for viewing and downloading. The high-resolution original is no longer
recoverable after deletion, and future processing can only use the retained
optimized master. Existing uploads are not automatically bulk rewritten.
When defining a custom profile with original retirement, make sure
replacement_preset names a conversion that profile actually generates.
AVIF compression effort
The three default conversions useavif_effort => 3 with quality 40/40/50 for
thumbnail, medium and large. Set 'avif_effort' => 6 on any preset in
processing.renditions or processing.model_renditions when you want to
spend more encoding time on compression. Studio maps effort to encoder speed
as 9 - effort. Previously scheduled conversions keep their saved recipes.
GD and ImageMagick use different encoder pipelines, so identical settings do not
promise byte-identical output to Sharp. ImageMagick normalizes to sRGB before
stripping profiles; GD does not provide equivalent ICC colour management.
Keep or retire earlier edits
By default, Studio keeps history for a managed file after a new edit is explicitly saved. Set this option inconfig/media-studio.php to retire the previous version after each future edit.