The Control Panel is a client of the same engine as Twig and CLI — same settings model, same Generation Service, same binary resolver.
Deployable truth still lives in config/super-images.php. The Settings screen visualizes that model and can edit derivative naming when the PHP file does not lock it.
Quick health overview:
No fake “total derivatives” counters from a database table — Super Images does not keep a derivative DB table.
Confirms:
Expands that profile’s variants × formats and runs the real pipeline.
You get:
Files land under preview/YYYYMMDD/… so they never collide with production derivatives.
php craft super-images/cleanup --previews-only --dry-run=1
php craft super-images/cleanup --previews-only --dry-run=0Retention: cleanup.previewRetentionDays (default 2).
php craft super-images/doctorUse this when formats, Imagick, or optimizers look wrong on a server.
Read-only overview of enabled state, profiles, adapters, encoders, and optimizers.
Editable section for path templates:
Also shows:
Why this matters: without a transform/identity token in the asset path, changing operations (sepia, crop, quality, …) can reuse a stale cached file. Defaults include {transformHash} for that reason.
If storage.naming is present in config/super-images.php, the form becomes read-only and points you to the PHP file.
Details: Storage.
| Permission | Access |
|---|---|
| super-images:view | Dashboard |
| super-images:playground | Playground |
| super-images:diagnostics | Diagnostics |
| super-images:manage-settings | Settings (including naming) |