Docs

Featured Image

The featured image of the current post, with an aspect ratio, a link, a caption and a fallback.

On this page

The Featured Image widget shows the featured image of the post being viewed. Use it in your blog post template, where each post gets its own picture, and in Loop item cards, where each card shows its post's image.

The top of a blog post: the title Designing around natural light, the excerpt, and a wide featured image of a living room with rounded corners
The Featured Image under the title in a blog post template, cropped to 16:9.

Where the image comes from

The image is the Featured image you set when you edit a post in WordPress (in the post sidebar). Its alternative text and caption come from the media library. For posts without a featured image, the widget shows the Fallback image, or nothing.

In the editor, the widget shows the image of the post chosen in Preview with in the Template settings (the Template button in the rail) (the latest post when it is empty).

Open your blog post template, or a Loop item, in the Theme Builder. Then click Insert in the rail on the left, find Featured Image in the Site & theme group (or type "featured" in the search box) and drag it where the image should go. See Add elements.

To give every image the same shape, whatever its original size, set an Aspect ratio in the Design tab, such as 16:9, and keep Object fit on Cover. Use Focus point to choose which part stays visible when the image is cropped.

Content tab settings

Content tab · Image
SettingWhat it does
ResolutionWhich image size WordPress sends: Thumbnail, Medium, Medium Large, Large, 1536x1536, 2048x2048 or Full. Default: Large.
Fallback imageShown when the post has no featured image.
LinkNone, The post (useful in cards), Image file (lightbox) (opens the full image in the lightbox) or Custom URL.
URLThe link address. Shown for Custom URL. Supports dynamic data.
Same link as the titleFor cards where the image and the title both open the post. The image still opens the post when clicked, but keyboard and screen reader users skip its link, so each card is announced as one link instead of two. Shown when Link is The post.
Show captionShows the image caption from the media library under the image.
LoadingAutomatic (lazy below the first section), Lazy or Eager, high priority (hero image). Automatic loads the image when visitors scroll near it, also in Loop Grid cards, unless it is in the page's first section. Footers, popups and mega menus never count as the first section. Use Eager for a large image at the top of the page, so it appears as fast as possible. Default: Automatic. See Performance.
AlignmentLeft, Center or Right. Can differ per device.

Design tab settings

Design tab
SectionSettings
ImageWidth, Max width, Height, Aspect ratio (Original, 1:1, 4:3, 3:2, 16:9, 21:9, 3:4, 4:5 or 2:3), Object fit (Cover, Contain or Fill), Focus point, Border radius, Border, Shadow, CSS filters, Hover effect (None, Zoom, Lift, Grayscale to color or Dim).
CaptionTypography, Color, Alignment, Spacing. Shown when Show caption is on.

The Design tab also has the sections every element shares: Spacing & position, Background & border and Mask. See Spacing, size & position.

Behaviour tab

The Behaviour tab has the settings every element shares: anchor and classes, entrance animations, motion effects, visibility per device, display conditions and interactions. A display condition on Featured image can hide a whole section for posts without one. See Display conditions.

Tips

  • Upload featured images at least as wide as the widget is on a large screen, so they stay sharp.
  • In a Loop item card where the Post Title has Link to the post on, set the image's Link to The post and turn on Same link as the title. Visitors can click either one, and keyboard users tab once per card.
  • The lightbox's look is set once for the whole site in the Design System. See Site behaviour.