---
title: "GFX - graphics configuration"
manual: "TYPO3 Explained"
version: "12.4"
permalink: "https://docs.typo3.org/permalink/t3coreapi:typo3confvars-gfx@12.4"
source: "Configuration/Typo3ConfVars/GFX.rst"
rendered: "2026-10-21T15:29:37+00:00"
---

> [!WARNING]
> **Attention**
>
> TYPO3 v12 has reached end-of-life as of April 30th 2026 and
> is no longer being maintained. Use the version switcher on the top
> left of this page to select documentation for a supported version of TYPO3.
>
> Need more time before upgrading?
> You can purchase Extended Long Term Support (ELTS) for TYPO3 v12 here:
> [TYPO3 ELTS](https://typo3.com/services/extended-support-elts).

<a id="typo3confvars-gfx-jpg-quality"></a>
<a id="typo3confvars-gfx-processor-interlace"></a>
<a id="typo3confvars-gfx-processor-colorspace"></a>
<a id="typo3confvars-gfx-processor-stripcolorprofileparameters"></a>
<a id="typo3confvars-gfx-processor-stripcolorprofilecommand"></a>
<a id="typo3confvars-gfx-processor-stripcolorprofilebydefault"></a>
<a id="typo3confvars-gfx-processor-allowtemporarymasksaspng"></a>
<a id="typo3confvars-gfx-processor-allowframeselection"></a>
<a id="typo3confvars-gfx-processor-allowupscaling"></a>
<a id="typo3confvars-gfx-processor-effects"></a>
<a id="typo3confvars-gfx-processor"></a>
<a id="typo3confvars-gfx-processor-path"></a>
<a id="typo3confvars-gfx-processor-enabled"></a>
<a id="typo3confvars-gfx-gdlib-png"></a>
<a id="typo3confvars-gfx-gdlib"></a>
<a id="typo3confvars-gfx-imagefile-ext"></a>
<a id="typo3confvars-gfx-gif-compress"></a>
<a id="typo3confvars-gfx-thumbnails-png"></a>
<a id="typo3confvars-gfx-thumbnails"></a>

# 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@12.4).

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@12.4)
-   [config/system/additional.php](https://docs.typo3.org/permalink/t3coreapi:typo3confvars-additional@12.4)

-   **thumbnails**

    -   *Type:* bool
    -   *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['thumbnails'\]
    -   *Default:* true

    Enables the use of thumbnails in the backend interface.

-   **thumbnails_png**

    -   *Type:* bool
    -   *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['thumbnails_png'\]
    -   *Default:* true

    If disabled, thumbnails from non-image files will be converted
    to gif, otherwise png (default).

-   **gif_compress**

    -   *Type:* bool
    -   *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['gif_compress'\]
    -   *Default:* true

    Enables the use of the
    `\TYPO3\CMS\Core\Imaging\GraphicalFunctionsgifCompress()` workaround
    function for compressing .gif files made with GD or IM, which probably use
    only RLE or no compression at all.

-   **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'

-   **$GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['imagefile_ext'\]**

    -   *type:* list
    -   *Default:* 'gif,jpg,jpeg,tif,tiff,bmp,pcx,tga,png,pdf,ai,svg'

    Comma-separated list of file extensions perceived as images by TYPO3.
    List should be set to `'gif,png,jpeg,jpg'` if IM is not available.
    Lowercase and no spaces between!

-   **gdlib**

    -   *Type:* bool
    -   *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['gdlib'\]
    -   *Default:* true

    Enables the use of GD.

-   **gdlib_png**

    -   *Type:* bool
    -   *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['gdlib_png'\]
    -   *Default:* false

    Enables the use of GD, with PNG only. This means that all items normally
    generated as gif-files will be png-files instead!

-   **processor_enabled**

    -   *Type:* bool
    -   *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['processor_enabled'\]
    -   *Default:* true

    Enables the use of Image- or GraphicsMagick.

-   **processor_path**

    -   *Type:* text
    -   *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['processor_path'\]
    -   *Default:* '/usr/bin/'

    Path to the IM tools convert, combine, identify.

-   **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**

    -   *Type:* bool
    -   *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['processor_effects'\]
    -   *Default:* false

    If enabled, apply blur and sharpening in ImageMagick/GraphicsMagick functions

-   **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**

    -   *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_allowTemporaryMasksAsPng**

    -   *Type:* bool
    -   *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['processor_allowTemporaryMasksAsPng'\]
    -   *Default:* false

    This should be set if your processor supports using PNGs as masks as this
    is usually faster.

-   **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**

    -   *Type:* string
    -   *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['processor_stripColorProfileCommand'\]

    <!-- TODO: no Markdown rendering for "versionchanged" -->

    This string-based configuration option has been superseded by
    $GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_stripColorProfileParameters']
    for security reasons.This option expected a string of command line parameters. The defined
    parameters had to be shell-escaped beforehand, while the new option
    [GFX - graphics configuration](https://docs.typo3.org/permalink/t3coreapi:typo3confvars-gfx-processor-stripcolorprofileparameters@12.4) 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:

    ```php
    // Before
    $GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_stripColorProfileCommand'] = '+profile \'*\'';

    // After
    $GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_stripColorProfileParameters'] = [
        '+profile',
        '*'
    ];
    ```

-   **processor_stripColorProfileParameters**

    -   *Type:* array of strings
    -   *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['processor_stripColorProfileParameters'\]
    -   *Default:* `['+profile', '*']`

    <!-- TODO: no Markdown rendering for "versionchanged" -->

    Specifies the parameters to strip the profile information, which can reduce
    thumbnail size up to 60KB. Command can differ in IM/GM, IM also knows the
    `-strip` command. See
    [imagemagick.org](https://legacy.imagemagick.org/Usage/thumbnails/#profiles)
    for details.

-   **processor_colorspace**

    -   *Type:* text
    -   *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['processor_colorspace'\]
    -   *Default:* RGB

    Specifies the colorspace to use. Some ImageMagick versions (like 6.7.0 and
    above) use the sRGB colorspace, so all images are darker then the original.

    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**

    -   *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**

    -   *Type:* int
    -   *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['GFX'\]\['jpg_quality'\]
    -   *Default:* 85
    -   *Allowed values:* Between 10 (lowest quality) and 100 (highest quality)

    <!-- TODO: no Markdown rendering for "versionadded" -->

    Lowest quality can be "1". Previously the lowest quality setting was "10".Default JPEG generation quality