fit
The fit parameter controls how the image will be constrained within the provided size (width and height) values, in order to maintain the correct proportions.
Syntax
fit={value}Allowed values
| Value | Description |
|---|---|
bounds | Resize the image to fit entirely within the specified region, making one dimension smaller if needed. |
cover | Resize the image to entirely cover the specified region, making one dimension larger if needed. |
crop | Resize and crop the image centrally to exactly fit the specified region. |
Notes
The fit parameter has no effect unless both width and height are specified.
Examples
Click the links to view the transformed image using a demo Fastly IO service.
| Example usage | Description |
|---|---|
?width=150&height=150&fit=bounds | Resize the image to fit within the bounds of 150px in width by 150px in height |
?width=150&height=150&fit=cover | Resize the image to entirely cover 150px in width by 150px in height |
?width=150&height=150&fit=crop | Crop the image to 150px in width by 150px in height |
User contributed notes
BETADo you see an error in this page? Do have an interesting use case, example or edge case people should know about? Share your knowledge and help people who are reading this page! (Comments are moderated; for support, please contact support@fastly.com)