Portfolio Image

Displays the media region of the current portfolio project: featured image, gallery slider, project video, or thumbnail grid. Use inside portfolio single templates. It is shown in the block inserter as Portfolio Image and registered as canvas-core/portfolio-image.

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

The Portfolio 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

  • Media ModeDefaultFeatured Image

    Which medium the block draws for the project: its featured image, a slider of its shots, its film, a grid of thumbnails, or the mosaic.

    ChoicesFeatured ImageGallery SliderVideoThumbnail GridMosaic Slider

  • Mosaic ColumnsDefault1,5,1,3,1,3,1

    Shots per column, comma-separated. 1 is a still column; more makes that column scroll vertically.

    Shown when Media Mode is "Mosaic Slider"

  • Image SizeDefaultLarge

    Which stored size of the image to load.

    ChoicesMedium LargeLargeFull

  • Link to ProjectDefaultOff

    Link the image to the project page.

    Shown when Media Mode is "Featured Image"

  • Hover OverlayDefaultOff

    Reveal a panel over the image while the pointer is on it.

    Shown when Media Mode is "Featured Image"

  • Aspect RatioDefaultEmpty

    Proportions the image is cropped to, for example 4/3 or 16/9. Empty keeps its natural shape.

    Shown when Media Mode is "Featured Image"

  • Media CSS ClassesDefaultEmpty

    Extra classes added to the media element itself: the image, or the video frame, e.g. rounded-6.

    Shown when Media Mode is "Featured Image" or "Video"

  • Image Inline StyleDefaultEmpty

    Inline style on the image itself, which is where a scroll-driven size belongs.

    Shown when Media Mode is "Featured Image"

  • Prefer Cover ImageDefaultOff

    Use the project's wide Cover image when it has one, falling back to the featured image.

    Shown when Media Mode is "Featured Image"

  • WrapperDefaultPortfolio Image container

    None emits the media on its own, so the surrounding layout block owns the box.

    ChoicesPortfolio Image containerNone (bare media)

  • Show Gallery (legacy)DefaultOff

    Legacy switch, prefer Media Mode: Gallery Slider.

    Shown when Media Mode is "Featured Image"

  • Gallery MotionDefaultFade

    Whether one shot crossfades into the next or slides across.

    ChoicesFadeSlideShown when Media Mode is "Gallery Slider"

  • Gallery Thumbnail StripDefaultOn

    Show a strip of small pictures below the slider that jump to a shot.

    Shown when Media Mode is "Gallery Slider"

  • Gallery ArrowsDefaultOff

    Show the previous and next arrows over the slider.

    Shown when Media Mode is "Gallery Slider"

  • Video URLDefaultEmpty

    Overrides the project's Video URL meta. YouTube, Vimeo, or Dailymotion.

    Shown when Media Mode is "Video"

  • Video FrameDefaultResponsive ratio box

    Whether the player keeps its own proportions or is left for the surrounding layout to size.

    ChoicesResponsive ratio boxBare player (the layout sizes it)Shown when Media Mode is "Video"

  • Player SizeDefault500x281

    Intrinsic width x height of the bare player. The surrounding layout still scales it; this only fixes the aspect.

    Shown when Video Frame is "Bare player (the layout sizes it)"

  • Thumbnail ColumnsDefault3

    How many thumbnails sit side by side.

    Shown when Media Mode is "Thumbnail Grid"

  • Thumbnail CSS ClassesDefaultEmpty

    Extra classes added to each thumbnail image tag.

    Shown when Media Mode is "Thumbnail Grid"

  • Large ThumbnailsDefaultEmpty

    Comma-separated positions rendered double-width, e.g. 3 or 1,6.

    Shown when Media Mode is "Thumbnail Grid"

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

Other blocks in Portfolio: Portfolio Archive Grid, Portfolio Categories, Portfolio Content, Portfolio Meta, Portfolio Navigation, Portfolio Related.

Was this page helpful?