---
title: "lim:uri.image"
manual: "LIA Imageserver"
version: "1.2"
permalink: "https://docs.typo3.org/permalink/lia/lia_imageserver:usage-uri-image@1.2"
source: "Usage/UriImage.rst"
modified: "2026-09-16T09:22:52+00:00"
---

# lim:uri.image

Based on the core ViewHelper `<f:uri.image>`. Adds the argument
`imageServerOptions`, which is taken into account during processing, and
returns the URL of the processed image.

For the inherited arguments see the core documentation of [f:uri.image](https://docs.typo3.org/other/typo3/view-helper-reference/14.3/en-us/Global/Uri/Image.html#typo3-fluid-uri-image). The
complete argument reference of this ViewHelper is generated from the source
code, see [Uri.image ViewHelper \<lim:uri.image>](https://docs.typo3.org/permalink/lia/lia_imageserver:lia-liaimageserver-uri-image@1.2).

> [!NOTE]
> TYPO3 strips the leading zero from hex codes like `015069` in arguments
> such as `blend-color`. In these cases, deviate from the image server
> documentation and prefix the value with `#`:
>
> **Hex color with leading zero**
>
> ```html
> imageServerOptions="{blend-color: '#015069', blend-alpha: 80}"
> ```

## Additional arguments

| Argument | Description | Type |
| --- | --- | --- |
| `imageServerOptions` | Options passed to the image server. Any valid image server option is allowed. These options overrule all other attributes. | array |
| `passThrough` | Skip the external image server. The URL points to the file processed by TYPO3. | bool |

## Example

**EXT:my_sitepackage/Resources/Private/Partials/Image.html**

```html
<picture>
    <lim:uri.image
        treatIdAsReference="true"
        src="{image.id}"
        width="600"
        height="400"
        cropVariant="tablet"
        imageServerOptions="{fm: 'pjpg', q: 'lossless'}"
        passThrough="true"
    />
</picture>
```

To activate cropping, add the suffix `m` to `width` and `height`:

**EXT:my_sitepackage/Resources/Private/Partials/Image.html**

```html
<picture>
    <lim:uri.image
        treatIdAsReference="true"
        src="{image.id}"
        width="600m"
        height="400m"
        cropVariant="tablet"
        imageServerOptions="{fm: 'pjpg', q: 'lossless'}"
        passThrough="true"
    />
</picture>
```

Inline notation:

**EXT:my_sitepackage/Resources/Private/Partials/Image.html**

```html
<picture>
    {lim:uri.image(treatIdAsReference: true, src: image.id, width: '600c', height: '400c', cropVariant: 'tablet', imageServerOptions: '{fm: "pjpg", q: "lossless"}', passThrough: true)}
</picture>
```