Imgix APIsRendering APIWatermark

Watermark

This family of parameters allows you to overlay image or text watermarks on top of your images. You can control the alignment, width, height, cropping, alpha transparency, padding, size, position, and rotation of the watermark separately from the base image. You can also obscure and reduce the length of the watermark’s URL.

You can also stack up to 4 independent watermark layers on a single image — see Multiple Watermarks on the mark parameter page.

Shadows, Reflections, Gradients and Fades on a Watermark

A watermark takes its own copies of four picture-level families, each prefixed mark-. They use the same values, defaults and limits as the unprefixed versions, with the differences noted below.

FamilyWhat it does
mark-drop-shadow and its 10 companionsA shadow shaped by the watermark’s own transparency, in all four shadow types
mark-reflection and its 6 companionsMirrors the watermark onto a glossy surface beneath it
mark-gradient and its 12 companionsA color gradient over the watermark, or a mask that fades it out
mark-fade and its 4 per-side companionsSoftens the watermark’s edges to transparent

Five things differ from the picture’s versions:

  • The canvas never grows. A watermark’s shadow and reflection are clipped at the image’s edge instead of expanding the output.
  • Lengths and fractions are the watermark’s, measured after mark-rot and any distortion — not the picture’s.
  • There is no AI mode. mark-drop-shadow-mode and mark-reflection-mode do not exist; a watermark always casts the card model.
  • mark-gradient and mark-fade are applied after mark-alpha, so they turn and warp with the watermark and each tile of mark-tile=grid gets its own.
  • A tiled watermark’s shadow depends on its type. Each tile of mark-tile=grid gets its own cast, float or inset shadow, and a tile’s cast can fall onto its neighbours — but a flat shadow, the default, is drawn once around the whole grid.

Every one of them is indexed like the other watermark parameters: mark-drop-shadow[1]=4. The unprefixed drop-shadow, reflection, gradient and fade parameters never apply to a watermark.