Face and plate privacy

Use face and license-plate detection for UGC moderation, testimonials, vehicle photos, and privacy-safe previews. Region params hide explicit coordinates when you already know what to obscure.

Face detection debug overlay and pixelated face privacy result — Group portrait validation with `face-debug=1` (left), then `?pixelateFaces=1` (right).

Vehicle license plate before and after automatic plate blur — License plate privacy - `?blurPlates=1&plate-debug=1` while validating. Remove debug before production.

Image with a blurred rectangular region — Region blur - `?blurRegion=120,320,220,80`.

Face blur and pixelation

Param	Value	Default
`blurFaces`	Blur detected faces. Accepts `1`, `true`, `yes`, or `on`.	`false`
`faceBlur`	Blur strength (`1`-`100`).	`32`
`faceBlurShape`	Mask shape: `round` (oval) or `square`.	`round`
`pixelateFaces`	Pixelate detected faces instead of blurring.	`false`
`facePixelate`	Pixel block size (`2`-`100`).	`16`

?w=900&blurFaces=1
?w=900&blurFaces=true&faceBlur=48
?w=900&pixelateFaces=1&facePixelate=24

Face privacy runs after resize/crop/text overlay and before final encoding, so detected boxes line up with the delivered image. Face detection is best-effort - review sensitive workflows manually. For crop behaviour centred on faces (gravity=face), see Resize, crop & fit and the deeper Smart cropping guide. Use face-debug=1 with gravity=face while validating crop behaviour. Debug boxes are rendered into the image response, so do not ship debug URLs in production.

License plate blur and pixelation

Automatic plate privacy currently applies to image CDN outputs. Video URLs can be transformed by the CDN, but frame-by-frame automatic plate redaction for full videos is a separate pipeline.

Param	Value	Default
`blurPlates`	Blur detected license plates. Accepts `1`, `true`, `yes`, or `on`.	`false`
`plateBlur`	Blur strength (`1`-`100`).	`40`
`pixelatePlates`	Pixelate detected license plates instead of blurring.	`false`
`platePixelate`	Pixel block size (`2`-`100`).	`14`
`plate-debug`	Draw detected plate boxes for testing.	`false`

?w=900&blurPlates=1
?w=900&pixelatePlates=1&platePixelate=18
?w=900&blurPlates=1&plate-debug=1

Plate detection is best-effort and depends on angle, distance, plate design, and source resolution. For legal or high-risk privacy workflows, combine automatic detection with plateRegion or regions=plate:... when you know the exact area. plate-debug=1 draws detection boxes into the returned image. It is useful in the Transform Lab and QA environments, but should be removed from production URLs.

Region privacy

Use output-pixel coordinates when you already know what should be hidden:

Param	Value
`blurRegion`	Blur explicit `x,y,w,h` region.
`pixelateRegion`	Pixelate explicit region. Optional `regionPixelate` amount.
`plateRegion`	Alias for blurring a license-plate region.
`regions`	Pipe-separated list: `blur:x,y,w,h:amount`, `pixelate:...`, `plate:...`.

?w=900&blurRegion=120,320,220,80
?w=900&pixelateRegion=120,320,220,80&regionPixelate=18
?w=900&regions=plate:120,320,220,80:44|blur:40,40,160,120:28

Coordinate-based plate privacy remains the most deterministic option when your app already knows the plate bounds.

Getting Started

Image CDN

Media Platform

SDKs & Integrations

Resources

Face blur and pixelation

License plate blur and pixelation

Region privacy

​Face blur and pixelation

​License plate blur and pixelation

​Region privacy

Face blur and pixelation

License plate blur and pixelation

Region privacy