Skip to main content

Negate

Use the negate transformation to invert colors in a delivered image variant.

Overview​

Negate is mostly used for stylized effects, visual debugging, or special-purpose image treatments. It is not usually appropriate for product images or user content where color accuracy matters.

Syntax​

FieldValue
Canonical parameternegate
Aliasneg
Value syntaxtrue, alpha:true, alpha:false, or an SDK object with alpha

Example​

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

Before and after​

Demo image with colors negated
Original transformation demo image

Best practices​

  • Use negate for explicit creative treatments or debugging.
  • Avoid negate where users need to understand original colors.
  • Keep negated variants separate from standard delivery variants in your app data or templates.

Common mistakes​

  • Using negate for product or brand images where color accuracy matters.
  • Expecting a negated image to remain accessible or readable without checking contrast.
  • Forgetting that negate changes the delivered variant only.

Last updated at: May 9, 2026