Skip to content

Image Focal Point

A photo shown in a wide carousel, or behind a hero's copy, is cropped to fit the frame: the frame is a different shape from the picture, so its edges are cut off. Without help the crop is taken around the middle of the picture, which cuts the heads off people photographed high in the frame.

A focal point marks the part of a picture to keep in view. It is stored on the image in the media library, so every block that shows the image uses it.

Setting it

Open the image in Media (/admin/media, then Edit) and click the part of the picture to keep in view, such as a face. The marker moves there and two previews show the picture cropped for a wide frame (banners and carousels) and a tall one (phones). The arrow keys move the point in steps of 5% (10% with Shift). Reset to centre removes it. Press Save image.

If AI image tagging is on, a new upload gets a focal point suggested by the model: the main person's face (or the middle of a group's faces), otherwise the main subject, and none when the subject is already in the middle of the picture. It is only set when the image has no focal point, so one chosen in the editor or through MCP is never replaced. If the edit page is open while the analysis finishes, the picker moves to the suggestion and says so; check the previews and move it if needed before saving.

Through MCP, manageMedia takes focalPoint on import and update, and every media reply includes it:

Value Meaning
"50 20" x then y, as percentages of the picture from its top-left corner (here: centred, a fifth of the way down)
"top", "center", "bottom", "left", "right" The middle of that edge
"none" Remove the focal point: crop around the centre

The focal point travels with the image in a site transfer.

Where it is used

Picture How
Carousel slides (staticCarouselExtension) The slide's own focalPoints entry if it has one, else its image's focal point
Hero background (hero, Centered and Gradient Overlay presets, including category banners built from a hero) The hero's focalPoint in heroConfig, else the image's
Hero slideshow photos (backgroundImages) Each photo's focalPoint, else the image's
Hero, Split Image preset (the heroImage photo beside the copy) The hero's focalPoint in heroConfig, else the image's
Blog masthead (blogMasthead, in Nova, Ridge and Diorama) The masthead image's
Blog cards (blogList, blogLatestPosts in all its layouts, blogRelatedArticles) Each post's masthead image's

Blocks store an image's address rather than the media item, so the item is found by its address: the stored key, the full address on the image host, a resized address (/fit-in/WxH/...) and a demo site's image path all find it. An image from outside the media library has no focal point unless the block gives one.

A block's own setting is for a picture used differently in one place, or one that isn't in the media library:

  • Carousel: focalPoints, a list matched to images (blank entries use the image's).
  • Hero: focalPoint beside backgroundImage (on the Split Image preset, for its heroImage photo), and on each backgroundImages entry.

Both take the same text form as MCP above.

Not used (yet) by product cards, whose photos are usually product shots cropped to the shop's image ratio, by the fundraiser hero banner, a jsonComponent container's backgroundImage or search result thumbnails, or by shoppable images, whose picture is never cropped (the hotspots need all of it).

How it is drawn

The storefront crops in the browser with object-position / background-position, so the same picture is cropped correctly at every screen width. Templates put two classes on the picture, nova-focal-x-NN nova-focal-y-NN (steps of 5%, defined in Nova's bdgr.css and so in every theme built on Nova), which set --focal-x / --focal-y; no inline styles. The decisions behind this are in the design notes.