height
The desired height of the output image.
The height
parameter enables dynamic height resizing based on pixels and percent values.
The {value}
can be either a positive integer or a positive number less than 1. If the value is an integer greater than or equal to 1, the value is interpreted as a pixel height. If the height parameter is less than 1, the value is interpreted as a percentage height.
Unless a width
parameter is present, the height
value will cause the width of the image to be scaled in proportion to the requested height. If both width and height are omitted, the input image dimensions are used.
Syntax
height={value}
value
may be one of:
- Absolute height: An integer number of pixels.
- Relative height: A fraction between 0 and 0.99 (e.g.,
0.5
) or a percentage between 0 and 100 followed by the letterp
(e.g.,50p
). In either case, the value indicates the desired height relative to the image's natural height.
Notes
- The maximum output dimensions are 8,192 x 8,192 pixels.
- Because we use a positive number between
0
and0.99
to return a percentage-based scaled image, in order to return an image that is 100% or more, ap
suffix can be appended to the value. For example,height=250p
would return an image that is250%
the height of the original. We usep
as a simple way to represent percentages. - If the requested height is not a whole number of pixels (e.g., as a result of applying a percentage value for
height
), it is rounded to the nearest integer.
Examples
Click the links to view the transformed image using a demo Fastly IO service.
Example usage | Description |
---|---|
?height=200 | Resize the height to 200px |
?height=0.10 | Resize the height to 10% of the input image |
?height=150p | Resize the height to 150% of the input image |
?height=200&width=0.50 | Force resize to a height of 200px and a width that is 50% of the original |
?height=150&width=150&fit=bounds | Fit image within a 150 x 150px rectangle |
?height=200&dpr=2 | Resize the height to 400px (200 CSS pixels for screens with a device pixel ratio of 2) |