--- title: "GFX - graphics configuration" manual: "TYPO3 Explained" version: "main" permalink: "https://docs.typo3.org/permalink/t3coreapi:typo3confvars-gfx@main" source: "Configuration/Typo3ConfVars/GFX.rst" rendered: "2026-09-20T15:52:37+00:00" --- # GFX - graphics configuration {#typo3confvars-gfx} You can test the graphics configuration in module **Environment > Image Processing**. See also [Image processing test tool](https://docs.typo3.org/permalink/t3coreapi:environment-test-image-processing@main). The following configuration variables can be used to configure settings for the handling of images and graphics: The configuration values listed here are keys in the global PHP array `$GLOBALS['TYPO3_CONF_VARS']['GFX']`. This variable can be set in one of the following files: - [config/system/settings.php](https://docs.typo3.org/permalink/t3coreapi:typo3confvars-settings@main) - [config/system/additional.php](https://docs.typo3.org/permalink/t3coreapi:typo3confvars-additional@main) ## thumbnails {#typo3confvars-gfx-thumbnails} - **thumbnails** - *Type:* bool - *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['thumbnails'\] - *Default:* true Enables the use of thumbnails in the backend interface. ## imagefile_ext {#typo3confvars-gfx-imagefile-ext} - **imagefile_ext** - *Type:* list - *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['imagefile_ext'\] - *Default:* 'gif,jpg,jpeg,tif,tiff,bmp,pcx,tga,png,pdf,ai,svg,webp' Comma-separated list of file extensions recognized as images by TYPO3. List should be set to `'gif,png,jpeg,jpg,webp'`, if ImageMagick / GraphicsMagick is not available. > [!WARNING] > **Caution** > > The file extensions must be in lowercase and there must be no spaces > between the commas and the file extensions! ## imageFileConversionFormats {#globals-typo3-conf-vars-sys-gfx-imagefileconversionformats} - **imageFileConversionFormats** - *Type:* `array` - *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['imageFileConversionFormats'\] - *Default:* \['jpg' => 'jpg', 'jpeg' => 'jpeg', 'gif' => 'gif', 'png' => 'png', 'svg' => 'svg', 'default' => 'png'\] Map source image extensions to the processing/output format used by TYPO3 when images are rendered (for example via ``). Keys are original file extensions, values are target file extensions. The special key `default` is used file extensions that are not explicitly listed. The option cannot be configured in the **System > Settings > Configure options ...** backend module, but only by directly editing file `config/system/additional.php` (recommended) or `config/system/settings.php`. **Example: Convert all JPEGs and GIFs to WebP by default** Convert all JPEGs and GIFs to WebP by default, keep SVGs untouched, and use PNG as fallback for all others. **config/system/additional.php** ```php 'webp', 'jpeg' => 'webp', 'gif' => 'webp', 'svg' => 'svg', 'default' => 'png', ]; ``` ## processor_enabled {#typo3confvars-gfx-processor-enabled} - **processor_enabled** - *Type:* bool - *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['processor_enabled'\] - *Default:* true Enables the use of Image- or GraphicsMagick. ## processor_path {#typo3confvars-gfx-processor-path} - **processor_path** - *Type:* text - *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['processor_path'\] - *Default:* '/usr/bin/' Path to the IM tools convert, combine, identify. ## processor {#typo3confvars-gfx-processor} - **processor** - *Type:* dropdown - *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['processor'\] - *Default:* 'ImageMagick' - *allowedValues:* 1 ImageMagick Choose ImageMagick for processing images GraphicsMagick Choose GraphicsMagick for processing images Select which external software on the server should process images - see also the preset functionality to see what is available. ## processor_effects {#typo3confvars-gfx-processor-effects} - **processor_effects** - *Type:* bool - *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['processor_effects'\] - *Default:* false If enabled, apply blur and sharpening in ImageMagick/GraphicsMagick functions ## processor_allowUpscaling {#typo3confvars-gfx-processor-allowupscaling} - **processor_allowUpscaling** - *Type:* bool - *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['processor_allowUpscaling'\] - *Default:* true If set, images can be scaled up if told so (in `\TYPO3\CMS\Core\Imaging\GraphicalFunctions`) ## processor_allowFrameSelection {#typo3confvars-gfx-processor-allowframeselection} - **processor_allowFrameSelection** - *Type:* bool - *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['processor_allowFrameSelection'\] - *Default:* true If set, the \[x\] frame selector is appended to input filenames in stdgraphic. This speeds up image processing for PDF files considerably. Disable if your image processor or environment cant cope with the frame selection. ## processor_stripColorProfileByDefault {#typo3confvars-gfx-processor-stripcolorprofilebydefault} - **processor_stripColorProfileByDefault** - *Type:* bool - *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['processor_stripColorProfileByDefault'\] - *Default:* true If set, the processor_stripColorProfileCommand is used with all processor image operations by default. See tsRef for setting this parameter explicitly for IMAGE generation. ## processor_stripColorProfileCommand {#typo3confvars-gfx-processor-stripcolorprofilecommand} - **processor_stripColorProfileCommand** - *Type:* string - *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['processor_stripColorProfileCommand'\] > [!NOTE] > This string-based configuration option has been superseded by > [$GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['processor_stripColorProfileParameters'\]](https://docs.typo3.org/permalink/t3coreapi:typo3confvars-gfx-processor-stripcolorprofileparameters@main) > for [security reasons](https://typo3.org/security/advisory/typo3-core-sa-2024-002). This option expected a string of command line parameters. The defined parameters had to be shell-escaped beforehand, while the new option [processor_stripColorProfileParameters](https://docs.typo3.org/permalink/t3coreapi:typo3confvars-gfx-processor-stripcolorprofileparameters@main) expects an array of strings that will be shell-escaped by TYPO3 when used. The existing configuration will continue to be supported. Still, it is suggested to use the new configuration format, as the Install Tool is adapted to allow modification of the new configuration option only: **config/system/additional.php (before and after)** ```php [!NOTE] > Images would be rendered darker than the original when using ImageMagick > in combination with "RGB". Possible values: CMY, CMYK, Gray, HCL, HSB, HSL, HWB, Lab, LCH, LMS, Log, Luv, OHTA, Rec601Luma, Rec601YCbCr, Rec709Luma, Rec709YCbCr, RGB, sRGB, Transparent, XYZ, YCbCr, YCC, YIQ, YCbCr, YUV ## processor_interlace {#typo3confvars-gfx-processor-interlace} - **processor_interlace** - *Type:* text - *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['processor_interlace'\] - *Default:* 'None' Specifies the interlace option to use. The result differs in different GM / IM versions. See manual of GraphicsMagick or ImageMagick for right option. Possible values: None, Line, Plane, Partition ## jpg_quality {#typo3confvars-gfx-jpg-quality} - **jpg_quality** - *Type:* int - *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['jpg_quality'\] - *Default:* 85 - *Allowed values:* Between 1 (low quality, small file size) and 100 (best quality, large file size) Default JPEG generation quality ## webp_quality {#typo3confvars-gfx-webp-quality} - **webp_quality** - *Type:* int | string - *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['webp_quality'\] - *Default:* 85 - *Allowed values:* Between 1 (low quality, small file size) and 100 (best quality, large file size), or "lossless" Default WebP generation quality. Setting the quality to "lossless" is equivalent to ["lossless" compression](https://developers.google.com/speed/webp/docs/compression#lossless_webp).