Skip to main content
This page covers configuration. For worker deployment and task scheduling, see Queues and scheduled maintenance.

Image thumbnails and workers

Thumbnails are separate files. Generating a thumbnail never overwrites its original. The grid uses the small rendition when it is ready; it does not download every full-size original to display a list.
Configure the selected Laravel queue connection and run its worker:
With connection => null, Studio uses the application’s default queue connection. A synchronous connection processes in the request; use a background worker when you want processing to continue independently. Processing status is persisted and can be refreshed after reopening the library. The native image renderer supports GD and ImageMagick through processing.native.driver (auto, gd, imagick). Codec availability determines which WebP/AVIF inputs and outputs can be processed. Native supported inputs are JPEG, PNG, WebP and AVIF; JPEG orientation is normalized. Images are not enlarged unless the selected recipe explicitly enables upscaling. Metadata preservation requires ImageMagick; image recipes explain the exact selection and failure behavior.

Select the right processing pipeline

Document generation has independent command/queue/inline controls. Enabling PDF text extraction or browser document preview does not enable PDF thumbnails. Likewise, enabling video trimming does not enable video posters. Consult the complete settings reference and capability matrix before configuring workers.