Hear from Slack, the ACLU, TED, & more at our customer summit in San Francisco Register

Resize Filter



The resize-filter parameter enables control over the resizing filter used to generate a new image with a higher or lower number of pixels.

API Pattern



Parameter Description
resize-filter Resizing filter.

Parameter Values

Value Description
nearest Uses the value of nearby translated pixel values.
bilinear Uses an average of a 2x2 environment of a pixels.
bicubic Uses an average of a 4x4 environment of pixels, weighing the innermost pixels higher.
lanczos2 Uses the Lanczos filter to increase the ability to detect edges and linear features within an image and uses sinc resampling to provide the best possible reconstruction.
lanczos3 Lanczos3 uses a better approximation of the sinc resampling function. (Default)

Parameter Aliases

Value Alias
linear bilinear
cubic bicubic
lanczos lanczos3


  1. When making an image smaller, use bicubic, which has a natural sharpening effect.
  2. When making an image larger, use bilinear, which has a natural smoothing effect.
  3. When resizing pixel art, use nearest, which has a natural pixelation effect.
  4. When quality is the main concern, use lanczos, which typically renders the best results.


Description HTML Demo
Use bilinear resize filtering - Deliver an image that has been resized using the bilinear filter. <img src="image.jpg?resize-filter=bilinear"/> Example