Extension Configuration 

Image processor: local:async (signed endpoint middleware), local:sync (static srcset, no middleware), imgproxy or imagor (offloaded). See Processors.

Largest image dimension in pixels. The width ladder is capped to this value.

Highest device pixel ratio a fixed-height tier ships a min-resolution <source> for. 3 emits 1×/2×/3× tiers; 2 drops the 3× tier; 1 disables per-DPR sources (single 1× height).

Width-ladder rungs (comma-separated px). An arbitrary requested width is quantized up to the nearest rung, which bounds the number of processed files and the set of signable URLs. The default ladder covers everything from small phones up to 4K (UHD) displays.

Design-system breakpoints (alias:min-width px) used to resolve a per-breakpoint aspect-ratio map. xs:0 is the base ratio.

The output format (avif or webp) applied uniformly to the <img> and every <source>.

AVIF quality. AVIF's scale sits lower than JPEG / WebP for the same perceived quality.

WebP quality.

Low-quality image placeholder. One of thumbhash, dominant-color or none. See Content Security Policy.

File extensions served verbatim as a plain <img>, never processed (vector / animated formats that carry no meaningful width ladder).

External providers only: base URL of the provider endpoint (e.g. https://imgproxy.example). See Offloaded processing with imgproxy and Offloaded processing with imagor.

External providers only: HMAC key. Encoding is provider-specific — imgproxy expects a hex-encoded key, imagor the plain IMAGOR_SECRET string. Empty → unsigned URLs (insecure / unsafe, dev only).

imgproxy only: HMAC salt (hex). imagor's scheme has no salt — leave empty there.

External providers only: origin prefix prepended to the source path. Leave empty when the provider resolves relative paths itself (imgproxy: IMGPROXY_BASE_URL; imagor: HTTP_LOADER_BASE_URL / HTTP_LOADER_DEFAULT_SCHEME + allowed sources).

Provider-specific extras passed through to the URL builder (e.g. a Cloudflare account hash). Not in the backend form — set it in config/system/settings.php under $GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['imaginator']['processorOptions']. Builders consume what they need and ignore the rest; see Custom Processor.

This map only feeds builders registered without extensionKey. A provider shipped as its own extension declares #[AsImaginatorProcessor('my-cdn', extensionKey: 'my_cdn')] and keeps its options in its own Extension Configuration namespace instead — with its own ext_conf_template.txt and backend form.