---
title: "Feature toggle"
manual: "Imaginator"
version: "main"
permalink: "https://docs.typo3.org/permalink/schliesser/imaginator:configuration-focus-area@main"
source: "Configuration/FeatureToggle.rst"
rendered: "2026-10-13T11:21:46+00:00"
---

# Feature toggle {#configuration-focus-area}

## Editor focus area {#editor-focus-area}

By default imaginator activates a **focus area** on the `default` crop variant
of every file reference: a movable box an editor draws to mark the part of the
image that must never be cropped away. When a rendered aspect ratio differs from
the source, the crop is centered on that box (falling back to the crop-area
center when none is set). See [Crop & Focus Area](https://docs.typo3.org/permalink/schliesser/imaginator:image-endpoint-crop@main).

Core offers no focus area out of the box, and declaring a crop variant replaces
core's implicit one, so imaginator re-supplies the stock variant (free crop plus
the standard `16:9`/`3:2`/`4:3`/`1:1` ratios) and appends the focus area.
An existing crop variant `default` configured by another extension or your
site is left untouched.

Activation is a default-on **feature toggle**, not an Extension Configuration
setting (it is read while the TCA is built). Disable it instance-wide in
[`config/system/settings.php`](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/Configuration/Typo3ConfVars/Index.html#file-project-config-system-settings-php):

**config/system/settings.php**

```php
$GLOBALS['TYPO3_CONF_VARS']['SYS']['features']['imaginator.focusArea'] = false;
```
