Slowly
The builderBlocks

Image

Place an image, from your media library or a dynamic source, with size and styling control.

The Image block places a picture on the page, decorative or load-bearing. It is what you reach for when the picture is content in its own right rather than a background fill.

Adding one

  1. Select the section or container to hold it.
  2. Open the inserter and search "image".
  3. Pick the Image block, then choose your source from the panel.

Settings

In the image's own panel. Layout, spacing, and effects are in the shared design panel.

SettingWhat it doesReach for it when
SourceThe image itself: pick from the media library or switch to dynamic to pull in a featured image or ACF fieldAlways; the block is empty until a source is set
Alt textThe written description attached to the image elementEvery image that carries meaning; leave empty only for pure decoration
CaptionOptional text shown beneath the imageA photo credit or a short label the visitor should read
SizeWhich WordPress-generated size is served (thumbnail, medium, large, full, or a custom registered size)Smaller sizes for thumbnails or card images; full for hero shots
Object fitHow the image fills its container: cover, contain, or noneCover when the image must fill a fixed box without letterboxing; contain to show the whole image
Object positionWhich part of the image stays centred when object fit crops itWhen cover cuts off a face or focal point you want to keep visible
LightboxOpens the full image in an overlay on clickPortfolio or product images where visitors want to zoom in
Lazy loadDefers loading until the image is near the viewportAlmost always on; turn off only for above-the-fold images that should load immediately
Disable srcsetStops WordPress from generating responsive size variantsRarely needed; useful if the image must always load at a fixed pixel size
AnimationA hover motion: zoom, pan, or similarA subtle zoom on a card image or a portfolio thumbnail

Styling

The full design panel is available: dimensions, spacing, borders, effects, and filters, each per breakpoint. The hover state is where animation timing and filter changes live when you want the image to respond to the pointer beyond the built-in animation options.

Accessibility

Every image that carries meaning needs alt text. Write what the image shows and why it is there, not a file name or a string of keywords. If the image is purely decorative, leave alt text empty so screen readers skip it rather than reading a file name aloud. For images inside a lightbox, the alt text on the thumbnail carries into the overlay, so it should describe the full image, not just the cropped view.

On this page