> For the complete documentation index, see [llms.txt](https://docs.cloudimage.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudimage.io/transformations/image-operations/crop/aspect-ratio-crop.md).
# Aspect ratio crop
Sets target aspect ratio or aspect ratio range when cropping. Aspect ratios can be set as decimal values (1.778) or ratios (16:9).
**aspect\_ratio=AR** | **ar=AR**
**aspect\_ratio=AR1,AR2** | **ar=AR1,AR2**
## **Crop and resize**
If you provide only one dimension parameter (**width** or **height**) and **aspect\_ratio**, the other dimension will be calculated. If you include both **width** and **height** in the URL, **aspect\_ratio** is ignored.
### Examples
| | |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Original aspect ratio (3:2 or 1.5):
/samples.scaleflex.com/car1.jpg?w=400
|
|  | Cropped to 1.8:
/samples.scaleflex.com/car1.jpg?w=400&aspect\_ratio=1.8
|
## Crop without resize
If you provide only **aspect\_ratio** and no dimensions (**width** or **height**), the image will be cropped without resizing.
### Examples
| Preview | Syntax |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Original aspect ratio (1.323):
/samples.scaleflex.com/frog.png
|
|  | Cropped to 3:2 (1.5):
/samples.scaleflex.com/frog.png?aspect\_ratio=3:2
|
## Aspect ratio range
You can specify a range of aspect ratio values, for example, **aspect\_ratio=4:3,16:9**. Images that fall within this range, will not be cropped. Useful to avoid very wide or very tall images by cropping them to the closest aspect ratio.
### Examples
| | |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Original aspect ratio 1.5:
/samples.scaleflex.com/car1.jpg?w=400
|
|  | Aspect ratio range 1.5..2 (no crop needed):
/samples.scaleflex.com/car1.jpg?w=400&aspect\_ratio=1.5,2.0
|
|  | Original aspect ratio 2.25:1 (2.25):
/samples.scaleflex.com/kids.jpg?w=400
|
|  | Aspect ratio range 3:2..2:1 (1.5..2):
/samples.scaleflex.com/kids.jpg?w=400&aspect\_ratio=3:2,2:1
|
