Skip to main content

Brightness

Use the brightness transformation to lighten or darken a delivered image variant.

Overview​

Brightness is useful for making generated images, thumbnails, or content images fit a consistent visual system. It can also help prepare images for overlays where the source is too dark or too bright.

Syntax​

FieldValue
Canonical parameterbrightness
Aliasbr
Accepted valuesNumber 0.01 through 10

Example​

https://cdn.imgwire.dev/{organization_id}/{environment_id}/{image_id}?brightness=1.35
image.url({
  brightness: 1.35,
  format: 'auto',
  quality: 'auto',
});
imgwire images url img_123 --brightness 1.35 --format auto --quality auto

Before and after​

Demo image with increased brightness
Original transformation demo image

Best practices​

  • Use modest changes for production images so highlights and shadows remain usable.
  • Combine brightness with Contrast when the image also needs stronger separation.
  • Use stable values for repeated UI variants.

Common mistakes​

  • Brightening already light images until highlights lose detail.
  • Using brightness as a substitute for source image quality or exposure correction.
  • Applying the same value to every uploaded image without testing varied content.

Last updated at: May 9, 2026