Watermark Extension for TYPO3, adding a ViewHelper that creates watermarks.

Installs: 1 810

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 1


0.9.0 2021-05-05 09:41 UTC

This package is auto-updated.

Last update: 2024-02-21 11:49:26 UTC


Latest Version

This extension adds a Fluid ViewHelper that adds a Watermark image on top of an image.


Open a command console, enter your project directory and execute the following command to download the latest stable version of this package:

$ composer require jw_301/jw_watermark

This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.

Alternatively, you can install it without composer through the Typo3 extension repository.


To use the watermark viewhelper, first import the watermark ViewHelper namespace at the beginning of the fluid HTML file like this (add the second line to an existing html tag):

<html xmlns:f="http://typo3.org/ns/TYPO3/CMS/Fluid/ViewHelpers" 

A typical usage then would look like this:

<a title="{file.title}" data-description="{file.description}" href="{jw:watermark(watermarkSrc: '/fileadmin/Watermark.png', watermarkOpacity: '1', watermarkBackgroundColor: 'FFFFFF', watermarkBackgroundOpacity: '0', watermarkOffset: 0, watermarkPositionVertical: 'bottom', src: file.uid, treatIdAsReference: 1, width: settings.media.popup.width, height: settings.media.popup.height)}">
    <f:render partial="Media/Rendering/Image" arguments="{file: file, dimensions: dimensions, settings: settings}" />

This will create a link to the image with the watermark image on top of it, with the preview (rendered through a partial) remaining unchanged.

The viewhelper can be used like the f:uri.image ViewHelper documented at https://docs.typo3.org/other/typo3/view-helper-reference/master/en-us/typo3/fluid/latest/Uri/Image.html with all its arguments.

The following additional arguments can be used to add the watermark:


The same as src, treatIdAsReference, image from the f:uri.image ViewHelper, but for the watermark image.


Opacity value for the watermark image (0=fully transparent, 1=fully opaque)


A color hex code to set a background color of the watermark


Opacity for the background color of the watermark (0=fully transparent, 1=fully opaque)


Horizontal position of the watermark in the image (left/center/right)


Vertical position of the watermark in the image (top/middle/bottom)


Offset from the edge in pixels (horizontally and vertically)


Currently, only PNG watermarks have been tested, but JPG Watermarks may work as well. Support for SVG ist unknown.

Also, the ViewHelper will only apply watermarks to JPEG images, not any other image formats.

Issues and feature requests

Please report issues and request features at https://github.com/JW301/jw_watermark/issues.