Image

Insert an image to make a visual statement.

• Name: core/image
• Category: media
• API Version: 3
• Block Type: Hybrid (static save + server enhancements)
• Keywords: img, photo, picture

Attributes

Defined via the attributes property in block.json.

Attribute	Type	Default	Description
blob	string	—	Role: local
url	string	—	Source: attribute. Selector: img. HTML attr: src. Role: content
alt	string	""	Source: attribute. Selector: img. HTML attr: alt. Role: content
caption	rich-text	—	Source: rich-text. Selector: figcaption. Role: content
lightbox	object	—	—
title	string	—	Source: attribute. Selector: img. HTML attr: title. Role: content
href	string	—	Source: attribute. Selector: figure > a. HTML attr: href. Role: content
rel	string	—	Source: attribute. Selector: figure > a. HTML attr: rel
linkClass	string	—	Source: attribute. Selector: figure > a. HTML attr: class
id	number	—	Role: content
width	string	—	—
height	string	—	—
aspectRatio	string	—	—
scale	string	—	—
focalPoint	object	—	—
sizeSlug	string	—	—
linkDestination	string	—	—
linkTarget	string	—	Source: attribute. Selector: figure > a. HTML attr: target
isDecorative	boolean	false	—

Supports

Defined via the supports property in block.json.

• interactivity: true
• align: "left", "center", "right", "wide", "full"
• anchor: true
• color:
  • text: false
  • background: false
• filter:
  • duotone: true
• spacing:
  • margin: true
• shadow: true

Context

Defined via the usesContext and providesContext properties in block.json.

Uses context:

• allowResize
• imageCrop
• fixedHeight
• navigationButtonType
• postId
• postType
• queryId
• galleryId

Block Styles

Defined via the styles property in block.json.

Style Name	Label	Default
default	Default	Yes
rounded	Rounded	No

CSS Selectors

Defined via the selectors property in block.json.

• dimensions: .wp-block-image img, .wp-block-image .components-placeholder
• border: .wp-block-image img, .wp-block-image .wp-block-image__crop-area, .wp-block-image .components-placeholder
• shadow: .wp-block-image img, .wp-block-image .wp-block-image__crop-area, .wp-block-image .components-placeholder
• filter:
  • duotone: .wp-block-image img, .wp-block-image .components-placeholder

Block Markup

This is a hybrid block. It saves static markup that the server may enhance during rendering.

<!-- wp:core/image -->
<figure class="wp-block-image"><img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAACklEQVR4nGMAAQAABQABDQottAAAAABJRU5ErkJggg==" alt="" /></figure>
<!-- /wp:core/image -->

Source

• block.json (reference)
• Source directory — browse the edit and save source files, index.php, and more.