Watermarks

Watermarks allow you to overlay custom images on top of your media files. This is commonly used for branding, copyright protection, or adding logos to images.

How Watermarks Work

Watermarks in PixelFiddler are pre-uploaded image files that can be applied to any media transformation. You first upload watermark images to your space, then reference them by name in your transformations.

To learn how to upload your first watermark and use it, see our watermark upload guide.

Quick reference

Parameter	Alias	Possible Values	See
watermark	wm	Uploaded watermark name	Basic Usage
watermark.opacity	wm.o	0-100	Opacity Control
watermark.size	wm.s	1-100	Size Control
watermark.width	wm.w	1-4096	Exact Dimensions
watermark.height	wm.h	1-4096	Exact Dimensions
watermark.position	wm.p	left, right, top, top_left, top_right, bottom, bottom_left, bottom_right, center	Position Control

Basic Watermark Usage

Once uploaded, apply watermarks using the watermark parameter:

Watermark

<img src="https://media.pixel-fiddler.com/{sourceAlias}/media/{imagePath}?wm=company-logo"/>

Show full parameter names instead of aliases

Opacity Control

Control the transparency of your watermark from 0 (nearly invisible) to 100 (fully opaque):

Watermark

Opacity

<img src="https://media.pixel-fiddler.com/{sourceAlias}/media/{imagePath}?wm=company-logo&wm.o=50"/>

Show full parameter names instead of aliases

Size Control

Control watermark size as a percentage of the image dimensions:

Watermark

Size in %

<img src="https://media.pixel-fiddler.com/{sourceAlias}/media/{imagePath}?wm=company-logo&wm.s=20"/>

Show full parameter names instead of aliases

Exact Dimensions

Set specific pixel dimensions for your watermark:

Watermark

Width

Height

<img src="https://media.pixel-fiddler.com/{sourceAlias}/media/{imagePath}?wm=company-logo&wm.w=100&wm.h=50"/>

Show full parameter names instead of aliases

Note: If only width is specified, height will automatically scale to maintain the watermark’s aspect ratio.

Position Control

Control where the watermark appears on your image using position:

Values:

• top_left
• top
• top_right
• middle_left
• center
• middle_right
• bottom_left
• bottom
• bottom_right

Watermark

Positioncentertoptop_rightmiddle_rightbottom_rightbottombottom_leftmiddle_lefttop_left

<img src="https://media.pixel-fiddler.com/{sourceAlias}/media/{imagePath}?wm=company-logo&wm.p=bottom_right"/>

Show full parameter names instead of aliases

Complete Example

Here’s a watermark with all parameters configured:

Watermark

Opacity

Size in %

Positioncenterbottom_righttop_left

<img src="https://media.pixel-fiddler.com/{sourceAlias}/media/{imagePath}?wm=company-logo&wm.o=70&wm.s=15&wm.p=bottom_right"/>

Show full parameter names instead of aliases

Best Practices

• File formats: Upload watermarks in PNG format for transparency support
• Size considerations: Keep watermark files reasonably sized for optimal performance
• Naming: Use descriptive, kebab-case names for easy reference
• Positioning: Consider using bottom_right for copyright notices or center for prominent branding
• Opacity: Start with 70-80% opacity for subtle branding, or 40-50% for background watermarks