---
title: "Configuration"
manual: "LIA Imageserver"
version: "2.3"
permalink: "https://docs.typo3.org/permalink/lia/lia_imageserver:configuration@2.3"
source: "Configuration/Index.rst"
modified: "2026-09-16T09:22:57+00:00"
---

# Configuration

## Extension configuration

The settings live in **Admin Tools > Settings > Extension
Configuration > lia_imageserver**.

-   **allowedFileExtensions**

    -   *Type:* string
    -   *Default:* (empty)
    -   *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['EXTENSIONS'\]\['lia_imageserver'\]\['allowedFileExtensions'\]

    Comma-separated list of file extensions that are handed to the image
    server. When empty, the extension falls back to
    `$GLOBALS['TYPO3_CONF_VARS']['GFX']['imagefile_ext']`. A value set in
    the image server configuration of a file storage takes precedence over
    this global setting.

-   **additionalParameter**

    -   *Type:* string
    -   *Default:* (empty)
    -   *Path:* $GLOBALS\['TYPO3_CONF_VARS'\]\['EXTENSIONS'\]\['lia_imageserver'\]\['additionalParameter'\]

    Additional parameter that is copied into the image server configuration of
    every file storage. The image server adapter decides how the value is
    used.

> [!NOTE]
> The configuration form also shows the field **Image Quality**
> (`imageQuality`). This extension does not read that value.

## Override the responsive image template

`<lim:widget.responsiveImage>` renders the template `Default.html`
from the directory set by the TypoScript constant
`plugin.tx_liaimageserver.settings.responsiveImageViewHelperTemplatePath`.
The constant expects a directory, not a file.

1.  Copy
    `EXT:lia_imageserver/Resources/Private/Templates/ViewHelpers/Widget/ResponsiveImage/Default.html`
    into your site package and adjust it.
1.  Point the constant to the new directory:

    **EXT:my_sitepackage/Configuration/TypoScript/constants.typoscript**

    ```typoscript
    plugin.tx_liaimageserver.settings {
        responsiveImageViewHelperTemplatePath = EXT:my_sitepackage/Resources/Private/Templates/ViewHelpers/Widget/ResponsiveImage/
    }
    ```
1.  Make sure the static template **LIA Imageserver** and your own
    TypoScript are included, see [Include the TypoScript](https://docs.typo3.org/permalink/lia/lia_imageserver:installation-typoscript@2.3).
