Image Focal Points
What it helps you do
Set where an image should stay centered when it is cropped to different shapes and sizes. A portrait stays on the face, a product shot stays on the label, and hero crops feel intentional instead of cutting off what matters.
Where to find it
- Media Library — open any image. The large preview and the Focal Point field in the sidebar both show a blue marker.
- Select Media or Edit Gallery — choose an image in the modal. The Attachment Details sidebar includes a Focal Point preview.
- Edit more details — from a media modal, open the classic attachment edit screen. The Focal Point field appears below the description.
- Post editor — after you set a Featured image, click the preview in the sidebar to adjust its focal point.
How to use it
- Open the image in any of the places above.
- Click the preview where you want the focus to stay, or type X and Y percentages (0–100).
- Switch to another image and back to confirm the marker stayed put.
You do not need to click Save on the classic attachment screen — focal point changes save on their own.
What happens automatically
- Focal points are stored on the image itself. Change it once and every place that image is cropped with focal-point support follows the new position.
- If you never set a point, the image defaults to the center (50%, 50%).
- Dirigible uses the saved point when displaying featured images and other focal-point-aware crops (for example, archive cards and grid layouts).
- A brief green outline confirms when a save completes in the post editor.
Things to know
- The blue marker is a guide for cropping — it does not move the whole image on the page by itself.
- SVG images work in the picker; very wide or viewBox-only files still show a usable preview.
- Focal points apply to the attachment, not to a single block. Two blocks using the same image share one focal point.
Related settings and guides
Screenshots
Editor
-
Adjust focal point while choosing a featured image in the editor.