Media Blocks
Image, video, audio, and file blocks.
core/image
Single image with optional caption.
Attributes:
id(integer) — Attachment IDurl(string) — Image URLalt(string) — Alt textcaption(rich-text) — Captiontitle(string) — Title attributehref(string) — Link URLrel(string) — Link rel attributelinkClass(string) — Link CSS classlinkDestination(string) — Link destination (none, media, attachment, custom)linkTarget(string) — Link targetwidth(string) — Widthheight(string) — HeightaspectRatio(string) — Aspect ratioscale(string) — Scale (cover, contain)sizeSlug(string) — Image size (thumbnail, medium, large, full)lightbox(object) — Lightbox settings
Supports: align, anchor, className, color, filter, spacing, shadow
Styles: default, rounded
core/gallery
Image gallery with multiple images.
Attributes:
images(array) — Deprecated: image dataids(array) — Attachment IDsshortCodeTransforms(array) — Shortcode datacolumns(integer) — Number of columns (default: 3)caption(rich-text) — Gallery captionimageCrop(boolean) — Crop images to fitrandomOrder(boolean) — Random orderfixedHeight(boolean) — Fixed heightlinkTarget(string) — Link targetlinkTo(string) — Link destination (none, media, attachment)sizeSlug(string) — Image sizeallowResize(boolean) — Allow resize
Supports: align, anchor, className, color, spacing, layout, units
core/video
Self-hosted video.
Attributes:
id(integer) — Attachment IDsrc(string) — Video URLcaption(rich-text) — Captionposter(string) — Poster image URLautoplay(boolean) — Autoplaycontrols(boolean) — Show controls (default: true)loop(boolean) — Loop playbackmuted(boolean) — MutedplaysInline(boolean) — Plays inlinepreload(string) — Preload (auto, metadata, none)tracks(array) — Subtitle tracks
Supports: align, anchor, className, color, spacing
core/audio
Self-hosted audio.
Attributes:
id(integer) — Attachment IDsrc(string) — Audio URLcaption(rich-text) — Captionautoplay(boolean) — Autoplayloop(boolean) — Looppreload(string) — Preload
Supports: align, anchor, className, color, spacing
core/cover
Image/video with text overlay.
Attributes:
id(integer) — Media IDurl(string) — Media URLuseFeaturedImage(boolean) — Use post featured imagealt(string) — Alt texthasParallax(boolean) — Fixed backgroundisRepeated(boolean) — Repeated backgrounddimRatio(integer) — Overlay opacity (0-100, default: 100)overlayColor(string) — Overlay color slugcustomOverlayColor(string) — Custom overlay colorbackgroundType(string) — Background type (image, video)focalPoint(object) — Focal point {x, y}minHeight(number) — Minimum heightminHeightUnit(string) — Height unitcontentPosition(string) — Content positionisDark(boolean) — Dark backgroundallowedBlocks(array) — Allowed inner blockstemplateLock(string/boolean) — Template lock
Supports: align, anchor, className, color, spacing, layout, dimensions
core/file
Downloadable file with optional embed.
Attributes:
id(integer) — Attachment IDhref(string) — File URLfileId(string) — Unique IDfileName(rich-text) — Display nametextLinkHref(string) — Link URLtextLinkTarget(string) — Link targetshowDownloadButton(boolean) — Show download buttondownloadButtonText(rich-text) — Button textdisplayPreview(boolean) — Show inline previewpreviewHeight(number) — Preview height
Supports: align, anchor, className, color, spacing
core/media-text
Two-column media and text layout.
Attributes:
mediaId(integer) — Media IDmediaUrl(string) — Media URLmediaLink(string) — Media linklinkDestination(string) — Link destinationlinkTarget(string) — Link targetlinkClass(string) — Link classrel(string) — Link relmediaAlt(string) — Alt textmediaPosition(string) — Media position (left, right)mediaType(string) — Media type (image, video)mediaWidth(number) — Media width % (default: 50)mediaSizeSlug(string) — Image sizeisStackedOnMobile(boolean) — Stack on mobile (default: true)verticalAlignment(string) — Vertical alignimageFill(boolean) — Fill containerfocalPoint(object) — Focal pointallowedBlocks(array) — Allowed inner blocks
Supports: align, anchor, className, color, spacing, typography