Imgix APIsRendering APIBackgroundBackground Removal Transparency Threshold

Background Removal Transparency Threshold

bg-remove-transparency-threshold

The bg-remove-transparency-threshold parameter controls whether background removal processing should be applied based on the amount of transparency already present in the source image. When an image’s transparency level is at or below the specified threshold, the background removal process is skipped entirely.

This parameter accepts a float value between 0.0 and 1.0, representing the transparency threshold. Examples:

  • 0.0: Process on all images regardless of transparency
  • 0.2 (default): Skips background removal if 20% or less of the image is transparent
  • 1.0: Only skips background removal only if the entire image is transparent

This parameter is used to avoid unnecessary processing on images that already have their backgrounds removed, as additional background removal may cause undesirable results.