---
title: "Crop & Focus Area"
manual: "Imaginator"
version: "main"
permalink: "https://docs.typo3.org/permalink/schliesser/imaginator:image-endpoint-crop@main"
source: "Usage/CropAndFocusArea.rst"
rendered: "2026-10-13T11:21:46+00:00"
---

# Crop & Focus Area {#image-endpoint-crop}

When an `image` (a FAL `FileReference`) is rendered, the editor's **crop
variant** is resolved server-side: imaginator reads the reference's crop JSON and
fits the requested ratio inside the **crop area**, centered on the **focus area**.
The framing the editor chose is honoured and in `local:async` mode the URL
keys only on the reference uid (`r…`).

The ladder is bounded by the crop area, so a tightly-cropped region is never
upscaled. A `src` given as a path or plain file uid (`f…`) has no crop data
and is center-cropped to the ratio.

> [!NOTE]
> **See also**
>
> The focus area is a default-on feature toggle (see
> [Feature toggle](https://docs.typo3.org/permalink/schliesser/imaginator:configuration-focus-area@main)). For the signed URL forms and the middleware,
> see [The image endpoint & signing](https://docs.typo3.org/permalink/schliesser/imaginator:image-endpoint@main).