Application integrations
Generate thumbnails for application files
Configure bounded on-demand thumbnail generation and verify the output disk.
Register existing thumbnails when your application already creates them. Enable this on-demand pipeline for eligible sources that need Studio to generate missing derivatives.
Configure a Laravel disk for generated files. Local storage and S3 are supported.
The cache disk can differ from the originals’ disks.
JPEG, PNG, WebP and AVIF inputs within these limits qualify. The PHP encoder must
support the input and output formats. Aspect ratio is preserved and small images
keep their existing size. Metadata is stripped. Studio verifies the encoded MIME
type and dimensions before publishing the result.
Run the configured worker and Laravel scheduler.
Set the worker timeout below the queue connection’s retry_after or visibility
timeout. Automatic generation requires a background queue. With a synchronous or
disabled queue, the grid shows file icons for missing thumbnails. Existing
registered or cached thumbnails remain available. Original image previews open
through the authorized original route.
Disable fallback generation for one source by setting generate_thumbnails to false
in that source’s configuration.
These limits account for current objects managed by this cache. S3 versioning can
retain noncurrent versions after deletion. Configure the bucket’s noncurrent
version lifecycle separately when versioning is enabled. Clean the old cache
before changing a cache disk’s physical location, or retain that disk configuration
until cleanup completes. Lowering limits stops new admission while cleanup
reclaims existing objects over successive batches.
The actor needs the department, source and indexing permissions. The JSON output
contains visited and ready counts and a nextAfter row ID. Pass that ID as
—after for the next batch. A null nextAfter means the current batch reached the
end. This permits controlled incremental preparation without scanning a bucket
or converting images during page rendering.