> 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/face-crop.md).
# Face crop
Finds the most prominent face in the image and crops it to the specified with the **width** and **height** parameters dimensions. If you however provide only one dimension, the other dimension will be chosen automatically to keep the aspect ratio of the face.
**func=face**
{% hint style="info" %}
If there is no face in the image or many faces are found, the operation defaults to a standard crop.
{% endhint %}
## Examples
| Preview | Syntax |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | Standard crop:
/samples.scaleflex.com/business-portfolio.jpg?w=400&h=300
|
|  | Face crop:
/samples.scaleflex.com/business-portfolio.jpg?w=400&h=300&func=face
|
|  | Face crop:
/samples.scaleflex.com/classroom.jpg?h=240&w=380&func=face
|
|  | Face crop with automatic aspect ratio:
/samples.scaleflex.com/classroom.jpg?h=240&func=face
|
## Face margin
Sets margins around the face. You can set equal margins with **face\_margin=X** or separate horizontal and vertical margins (**face\_margin=W,H**).
**face\_margin=X|W,H**
### Examples
| Preview | Syntax |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | [/samples.scaleflex.com/business-portfolio.jpg?**w=400**&**h=300**&**func=face**&**face\_margin=60**](https://doc.cloudimg.io/https://samples.scaleflex.com/business-portfolio.jpg?w=400\&h=300\&func=face\&face_margin=60) |
|  | [/samples.scaleflex.com/classroom.jpg?**h=240**&**func=face**&**face\_margin=80,30**](https://doc.cloudimg.io/https://samples.scaleflex.com/classroom.jpg?h=240\&func=face\&face_margin=80,30) |
