---
title: "IMAGE"
manual: "TypoScript Explained"
version: "main"
permalink: "https://docs.typo3.org/permalink/t3tsref:gifbuilder-image@main"
source: "Gifbuilder/ObjectNames/Image/Index.rst"
rendered: "2026-09-27T06:53:55+00:00"
---

# IMAGE {#gifbuilder-image}

Renders an image file.

## Properties {#gifbuilder-image-properties}

-   [align](https://docs.typo3.org/permalink/t3tsref:align@main)
-   [file](https://docs.typo3.org/permalink/t3tsref:file@main)
-   [mask](https://docs.typo3.org/permalink/t3tsref:mask@main)
-   [offset](https://docs.typo3.org/permalink/t3tsref:offset@main)
-   [tile](https://docs.typo3.org/permalink/t3tsref:tile@main)

### align {#gifbuilder-image-align}

-   **align**

    -   *Type:* VHalign / [stdWrap](https://docs.typo3.org/permalink/t3tsref:stdwrap@main)
    -   *Default:* 1,1

    Pair of values, which defines the horizontal and vertical alignment of
    the image.

    **Values:**

    Horizontal alignment:

    -   **l**

        left

    -   **c**

        center

    -   **r**

        right

    Vertical alignment:

    -   **t**

        top

    -   **c**

        center

    -   **b**

        bottom

    **Example:**

    Horizontally centered, vertically at the bottom:

    **EXT:site_package/Configuration/Sets/Main/setup.typoscript**

    ```typoscript
    align = c, b
    ```

### file {#gifbuilder-image-file}

-   **file**

    -   *Type:* [imgResource](https://docs.typo3.org/permalink/t3tsref:data-type-imgresource@main)

    The image file.

### mask {#gifbuilder-image-mask}

-   **mask**

    -   *Type:* [imgResource](https://docs.typo3.org/permalink/t3tsref:data-type-imgresource@main)

    Optional mask image for the image file.

### offset {#gifbuilder-image-offset}

-   **offset**

    -   *Type:* x,y [+calc](https://docs.typo3.org/permalink/t3tsref:gifbuilder-calc@main) / [stdWrap](https://docs.typo3.org/permalink/t3tsref:stdwrap@main)
    -   *Default:* 0,0

    Offset of the image.

### tile {#gifbuilder-image-tile}

-   **tile**

    -   *Type:* x,y / [stdWrap](https://docs.typo3.org/permalink/t3tsref:stdwrap@main)
    -   *Default:* 1,1

    Repeat the image x,y times (which creates the look of tiles).

    Maximum number of times in each direction is 20. If you need more,
    use a larger image.