From b57609789ac8f189c0fbb67a351c8f28231f016d Mon Sep 17 00:00:00 2001
From: deanna-cf <156966162+deanna-cf@users.noreply.github.com>
Date: Tue, 15 Jul 2025 09:14:59 -0700
Subject: [PATCH] Create changelog-face-cropping

---
 .../changelog/images/changelog-face-cropping     | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)
 create mode 100644 src/content/changelog/images/changelog-face-cropping

diff --git a/src/content/changelog/images/changelog-face-cropping b/src/content/changelog/images/changelog-face-cropping
new file mode 100644
index 000000000000000..1d09190d07a1599
--- /dev/null
+++ b/src/content/changelog/images/changelog-face-cropping
@@ -0,0 +1,16 @@
+---
+title: Automatic face cropping in Images
+description: When optimizing with Images, automatically crop images toward detected faces.
+date: 2025-07-18
+---
+You can now use Images to [automatically crop images toward detected faces](/images/transform-images/transform-via-url/#gravity).
+
+The `gravity=face` option automatically detects which pixels represent the face (or faces) in an image, and sets a new focal point based on detected faces. If no faces are found, then the focal point will fall back to the center of the image.
+
+This can be combined with the `zoom` paramter to control how much of the surrounding area will be included in the image. Valid range is from `0` to `1`:
+- **`0` includes as much of the background as possible
+- **`1` crops as closely to the face as possible
+
+![Example of face cropping](~/assets/images/changelog/images/face-cropping.png)
+
+Refer to the [Images documentation](/images/transform-images/transform-via-url) for more information.