Canvas Docs

Post Image

Displays the current post featured image with configurable size and optional permalink link. It is shown in the block inserter as Post Image and registered as canvas-core/post-image.

Select the block on a page and its own settings open in the sidebar, in the panels below:

The Post Image settings in the block editor sidebar

Settings

Each setting is named exactly as the block editor names it, followed by what it does and what it starts as. Where a setting carries a Shown when line, it stays hidden until that condition is met, which is the usual reason a setting looks missing from the sidebar:

Settings

  • Image SizeDefaultMedium Large

    Which stored copy of the featured image is served. A small card does not need the full-size file, and a smaller one loads faster.

    ChoicesThumbnailMediumMedium LargeLargeFull

  • Wrap in .entry-imageDefaultOn

    On by default. Turn off for the design's flat shape, where the link itself carries the entry-image class instead of sitting inside a container.

  • Container ClassesDefaultentry-image

    The class the picture's container carries, or, with the wrapper off, the class that moves onto the link or the image. Clear it for a card whose whole box is already the link and whose picture is unclassed.

  • Link to PostDefaultOn

    Makes the picture clickable. Turn it off where the whole card is already a link, so a reader does not get a link inside a link.

  • Link DestinationDefaultThe post permalink

    Embed URL falls back to the permalink when a post has none.

    ChoicesThe post permalinkThe post's Embed URL (Blog Media)The full-size image file (lightbox)Shown when Link to Post is on

  • Open in LightboxDefaultEmpty

    Opens what the picture points at in an overlay on the same page instead of navigating away. Match the choice to the target: Iframe for a video or a map, Image for a photo, Gallery to step through every picture in the listing.

    ChoicesNo lightbox (empty)Iframe (video / map)ImageGalleryShown when Link to Post is on

  • Overlay IconDefaultEmpty

    Badge drawn over the picture, such as a play symbol that marks a video post.

    Shown when Link to Post is on

  • Overlay TextDefaultEmpty

    Words shown in that badge, beside the icon or in place of it.

    Shown when Link to Post is on

  • Image ClassesDefaultEmpty

    Classes for the itself, not the container.

  • Crop To RatioDefaultEmpty

    Cards in a row sit at different heights when their pictures are different shapes. Choosing a ratio crops every picture to it in the browser, centred, leaving the original untouched.

    ChoicesThe picture's own shape (empty)Landscape 3:2Landscape 4:3Widescreen 16:9SquarePortrait 2:3

  • Overlay ClassDefaultEmpty

    Wrapper class for the overlay badge. Empty uses play-icon.

    Shown when Link to Post is on

Every Canvas block also carries the Animation, Scroll Effects and Advanced panels, which are described in Controls every Canvas block has.

Other blocks in Posts: Blog Archive Loop, Blog Loop, Blog Single Post, Post Archive Index, Post Author, Post Comments.

Was this page helpful?