Block reference


Archives

Display a monthly archive of your posts.

Category: Widgets.

Source: View source on Github

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Align:
    • Type: String.
    • Enum: left, center, right, wide, full,
  • ClassName:
    • Type: String.
  • DisplayAsDropdown:
    • Type: Boolean.
    • Default: False.
  • ShowPostCounts:
    • Type: Boolean.
    • Default: False.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Align: True.
  • Html: False.

Audio

Embed a simple audio player.

Category: Media.

Source: View source on Github

CSS Class: wp-block-audio

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Src:
    • Type: String.
    • Source: Attribute.
    • Selector: Audio.
    • Attribute: Src.
  • Caption:
    • Type: String.
    • Source: Html.
    • Selector: Figcaption.
  • Id:
    • Type: Number.
  • Autoplay:
    • Type: Boolean.
    • Source: Attribute.
    • Selector: Audio.
    • Attribute: Autoplay.
  • Loop:
    • Type: Boolean.
    • Source: Attribute.
    • Selector: Audio.
    • Attribute: Loop.
  • Preload:
    • Type: String.
    • Source: Attribute.
    • Selector: Audio.
    • Attribute: Preload.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Align: True.
  • LightBlockWrapper: True.

Block

Reusable blocks

Create and save content to reuse across your site. Update the block, and the changes apply everywhere it’s used.

Category: Reusable.

Source: View source on Github

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Ref:
    • Type: Number.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • CustomClassName: False.
  • Html: False.
  • Inserter: False.

Button

Prompt visitors to take action with a button-style link.

Category: Design.

Source: View source on Github

Parent

Optional. Type: Array.

Blocks are able to be inserted into blocks that use InnerBlocks as nested content. Setting parent lets a block require that it is only available when nested within the specified blocks.

Documentation

core/buttons

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Url:
    • Type: String.
    • Source: Attribute.
    • Selector: A.
    • Attribute: Href.
  • Title:
    • Type: String.
    • Source: Attribute.
    • Selector: A.
    • Attribute: Title.
  • Text:
    • Type: String.
    • Source: Html.
    • Selector: A.
  • LinkTarget:
    • Type: String.
    • Source: Attribute.
    • Selector: A.
    • Attribute: Target.
  • Rel:
    • Type: String.
    • Source: Attribute.
    • Selector: A.
    • Attribute: Rel.
  • Placeholder:
    • Type: String.
  • BorderRadius:
    • Type: Number.
  • Style:
    • Type: Object.
  • BackgroundColor:
    • Type: String.
  • TextColor:
    • Type: String.
  • Gradient:
    • Type: String.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Align: True.
  • AlignWide: False.
  • Reusable: False.
  • LightBlockWrapper: True.

Buttons

Prompt visitors to take action with a button-style link.

Category: Design.

Source: View source on Github

CSS Class: wp-block-buttons

Block Grammar & Markup

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Align: True.
  • AlignWide: False.
  • LightBlockWrapper: True.

Transforms

Optional. Type: Array.

Transforms provide rules for what a block can be transformed from and what it can be transformed to.

Documentation

Transforms to: button,


Calendar

A calendar of your site’s posts.

Category: Widgets.

Source: View source on Github

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Align:
    • Type: String.
    • Enum: left, center, right, wide, full,
  • ClassName:
    • Type: String.
  • Month:
    • Type: Integer.
  • Year:
    • Type: Integer.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Align: True.

Categories

Display a list of all categories.

Category: Widgets.

Source: View source on Github

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Align:
    • Type: String.
    • Enum: left, center, right, wide, full,
  • ClassName:
    • Type: String.
  • DisplayAsDropdown:
    • Type: Boolean.
    • Default: False.
  • ShowHierarchy:
    • Type: Boolean.
    • Default: False.
  • ShowPostCounts:
    • Type: Boolean.
    • Default: False.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Align: True.
  • Html: False.

Freeform

The Classic block

Category: Text.

Source: View source on Github

CSS Class: wp-some-class

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Content:
    • Type: String.
    • Source: Html.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • ClassName: False.
  • CustomClassName: False.
  • Reusable: False.

Code

Display code snippets that respect your spacing and tabs.

Category: Text.

Source: View source on Github

CSS Class: wp-block-code

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Content:
    • Type: String.
    • Source: Text.
    • Selector: Code.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Html: False.
  • LightBlockWrapper: True.

Transforms

Optional. Type: Array.

Transforms provide rules for what a block can be transformed from and what it can be transformed to.

Documentation

Transforms to: html,


Column

A single column within a columns block.

Category: Text.

Source: View source on Github

CSS Class: wp-block-column

Block Grammar & Markup

Parent

Optional. Type: Array.

Blocks are able to be inserted into blocks that use InnerBlocks as nested content. Setting parent lets a block require that it is only available when nested within the specified blocks.

Documentation

core/columns

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • VerticalAlignment:
    • Type: String.
  • Width:
    • Type: Number.
    • Min: 0.
    • Max: 100.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Reusable: False.
  • Html: False.
  • LightBlockWrapper: True.

Columns

Add a block that displays content in multiple columns, then add whatever content blocks you’d like.

Category: Design.

Source: View source on Github

CSS Class: wp-block-columns

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • VerticalAlignment:
    • Type: String.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Align: wide, full,
  • Html: False.
  • LightBlockWrapper: True.
  • __experimentalColor: gradients: True. linkColor: True.

Cover

Add an image or video with a text overlay — great for headers.

Category: Media.

Source: View source on Github

CSS Class: wp-block-cover

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Url:
    • Type: String.
  • Id:
    • Type: Number.
  • HasParallax:
    • Type: Boolean.
    • Default: False.
  • DimRatio:
    • Type: Number.
    • Default: 50.
  • OverlayColor:
    • Type: String.
  • CustomOverlayColor:
    • Type: String.
  • BackgroundType:
    • Type: String.
    • Default: Image.
  • FocalPoint:
    • Type: Object.
  • MinHeight:
    • Type: Number.
  • MinHeightUnit:
    • Type: String.
  • Gradient:
    • Type: String.
  • CustomGradient:
    • Type: String.
  • ContentPosition:
    • Type: String.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Align: True.
  • Html: False.
  • LightBlockWrapper: True.
  • __experimentalPadding: True.

Transforms

Optional. Type: Array.

Transforms provide rules for what a block can be transformed from and what it can be transformed to.

Documentation

Transforms from: image, video,

Transforms to: image, video,


File

Add a link to a downloadable file.

Category: Media.

Source: View source on Github

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Id:
    • Type: Number.
  • Href:
    • Type: String.
  • FileName:
    • Type: String.
    • Source: Html.
    • Selector: A:not([download]).
  • TextLinkHref:
    • Type: String.
    • Source: Attribute.
    • Selector: A:not([download]).
    • Attribute: Href.
  • TextLinkTarget:
    • Type: String.
    • Source: Attribute.
    • Selector: A:not([download]).
    • Attribute: Target.
  • ShowDownloadButton:
    • Type: Boolean.
    • Default: True.
  • DownloadButtonText:
    • Type: String.
    • Source: Html.
    • Selector: A[download].

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Align: True.

Transforms

Optional. Type: Array.

Transforms provide rules for what a block can be transformed from and what it can be transformed to.

Documentation

Transforms to: audio, video, image,


Gallery

Display multiple images in a rich gallery.

Category: Media.

Source: View source on Github

CSS Class: wp-block-gallery

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Images:
    • Type: Array.
    • Default:
    • Source: Query.
    • Selector: .blocks-gallery-item.
    • Query:
      • url:
        • type: string.
        • source: attribute.
        • selector: img.
        • attribute: src.

      • fullUrl:
        • type: string.
        • source: attribute.
        • selector: img.
        • attribute: data-full-url.

      • link:
        • type: string.
        • source: attribute.
        • selector: img.
        • attribute: data-link.

      • alt:
        • type: string.
        • source: attribute.
        • selector: img.
        • attribute: alt.
        • default: [].

      • id:
        • type: string.
        • source: attribute.
        • selector: img.
        • attribute: data-id.

      • caption:
        • type: string.
        • source: html.
        • selector: .blocks-gallery-item__caption.
  • Ids:
    • Type: Array.
    • Items: type: number,
    • Default:
  • Columns:
    • Type: Number.
    • Minimum: 1.
    • Maximum: 8.
  • Caption:
    • Type: String.
    • Source: Html.
    • Selector: .blocks-gallery-caption.
  • ImageCrop:
    • Type: Boolean.
    • Default: True.
  • LinkTo:
    • Type: String.
    • Default: None.
  • SizeSlug:
    • Type: String.
    • Default: Large.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Align: True.

Transforms

Optional. Type: Array.

Transforms provide rules for what a block can be transformed from and what it can be transformed to.

Documentation

Transforms from: image,

Transforms to: image,


Group

A block that groups other blocks.

Category: Design.

Source: View source on Github

CSS Class: wp-block-group

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • TagName:
    • Type: String.
    • Default: Div.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Align: wide, full,
  • Anchor: True.
  • Html: False.
  • LightBlockWrapper: True.
  • __experimentalColor: gradients: True. linkColor: True.

Heading

Introduce new sections and organize content to help visitors (and search engines) understand the structure of your content.

Category: Text.

Source: View source on Github

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Align:
    • Type: String.
  • Content:
    • Type: String.
    • Source: Html.
    • Selector: H1,h2,h3,h4,h5,h6.
    • Default: .
  • Level:
    • Type: Number.
    • Default: 2.
  • Placeholder:
    • Type: String.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Anchor: True.
  • ClassName: False.
  • LightBlockWrapper: True.
  • __experimentalColor: linkColor: True.
  • __experimentalFontSize: True.
  • __experimentalLineHeight: True.
  • __experimentalSelector: core/heading/h1: h1, core/heading/h2: h2, core/heading/h3: h3, core/heading/h4: h4, core/heading/h5: h5, core/heading/h6: h6,
  • __unstablePasteTextInline: True.

Transforms

Optional. Type: Array.

Transforms provide rules for what a block can be transformed from and what it can be transformed to.

Documentation

Transforms to: paragraph,


Html

Add custom HTML code and preview it as you edit.

Category: Widgets.

Source: View source on Github

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Content:
    • Type: String.
    • Source: Html.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • CustomClassName: False.
  • ClassName: False.
  • Html: False.

Transforms

Optional. Type: Array.

Transforms provide rules for what a block can be transformed from and what it can be transformed to.

Documentation

Transforms to: code,


Image

Insert an image to make a visual statement.

Category: Media.

Source: View source on Github

CSS Class: wp-block-image

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Align:
    • Type: String.
  • Url:
    • Type: String.
    • Source: Attribute.
    • Selector: Img.
    • Attribute: Src.
  • Alt:
    • Type: String.
    • Source: Attribute.
    • Selector: Img.
    • Attribute: Alt.
    • Default: .
  • Caption:
    • Type: String.
    • Source: Html.
    • Selector: Figcaption.
  • Title:
    • Type: String.
    • Source: Attribute.
    • Selector: Img.
    • Attribute: Title.
  • Href:
    • Type: String.
    • Source: Attribute.
    • Selector: Figure > a.
    • Attribute: Href.
  • Rel:
    • Type: String.
    • Source: Attribute.
    • Selector: Figure > a.
    • Attribute: Rel.
  • LinkClass:
    • Type: String.
    • Source: Attribute.
    • Selector: Figure > a.
    • Attribute: Class.
  • Id:
    • Type: Number.
  • Width:
    • Type: Number.
  • Height:
    • Type: Number.
  • SizeSlug:
    • Type: String.
  • LinkDestination:
    • Type: String.
    • Default: None.
  • LinkTarget:
    • Type: String.
    • Source: Attribute.
    • Selector: Figure > a.
    • Attribute: Target.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • LightBlockWrapper: True.

Latest-comments

Display a list of your most recent comments.

Category: Widgets.

Source: View source on Github

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Align:
    • Type: String.
    • Enum: left, center, right, wide, full,
  • ClassName:
    • Type: String.
  • CommentsToShow:
    • Type: Number.
    • Default: 5.
    • Minimum: 1.
    • Maximum: 100.
  • DisplayAvatar:
    • Type: Boolean.
    • Default: True.
  • DisplayDate:
    • Type: Boolean.
    • Default: True.
  • DisplayExcerpt:
    • Type: Boolean.
    • Default: True.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Align: True.
  • Html: False.

Latest-posts

Display a list of your most recent posts.

Category: Widgets.

Source: View source on Github

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Align:
    • Type: String.
    • Enum: left, center, right, wide, full,
  • ClassName:
    • Type: String.
  • Categories:
    • Type: Array.
    • Items: type: object,
  • SelectedAuthor:
    • Type: Number.
  • PostsToShow:
    • Type: Number.
    • Default: 5.
  • DisplayPostContent:
    • Type: Boolean.
    • Default: False.
  • DisplayPostContentRadio:
    • Type: String.
    • Default: Excerpt.
  • ExcerptLength:
    • Type: Number.
    • Default: 55.
  • DisplayAuthor:
    • Type: Boolean.
    • Default: False.
  • DisplayPostDate:
    • Type: Boolean.
    • Default: False.
  • PostLayout:
    • Type: String.
    • Default: List.
  • Columns:
    • Type: Number.
    • Default: 3.
  • Order:
    • Type: String.
    • Default: Desc.
  • OrderBy:
    • Type: String.
    • Default: Date.
  • DisplayFeaturedImage:
    • Type: Boolean.
    • Default: False.
  • FeaturedImageAlign:
    • Type: String.
    • Enum: left, center, right,
  • FeaturedImageSizeSlug:
    • Type: String.
    • Default: Thumbnail.
  • FeaturedImageSizeWidth:
    • Type: Number.
    • Default: .
  • FeaturedImageSizeHeight:
    • Type: Number.
    • Default: .

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Align: True.
  • Html: False.

Legacy-widget

Display a legacy widget.

Category: Widgets.

Source: View source on Github

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • WidgetClass:
    • Type: String.
  • Id:
    • Type: String.
  • IdBase:
    • Type: String.
  • Number:
    • Type: Number.
  • Instance:
    • Type: Object.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Html: False.
  • CustomClassName: False.

List

Create a bulleted or numbered list.

Category: Text.

Source: View source on Github

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Ordered:
    • Type: Boolean.
    • Default: False.
  • Values:
    • Type: String.
    • Source: Html.
    • Selector: Ol,ul.
    • Multiline: Li.
    • __unstableMultilineWrapperTags: ol, ul,
    • Default: .
  • Type:
    • Type: String.
  • Start:
    • Type: Number.
  • Reversed:
    • Type: Boolean.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • ClassName: False.
  • __unstablePasteTextInline: True.
  • LightBlockWrapper: True.

Transforms

Optional. Type: Array.

Transforms provide rules for what a block can be transformed from and what it can be transformed to.

Documentation

Transforms from: paragraph,

Transforms to: paragraph, quote,


Media-text

Set media and words side-by-side for a richer layout.

Category: Media.

Source: View source on Github

CSS Class: wp-block-media-text

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Align:
    • Type: String.
    • Default: Wide.
  • MediaAlt:
    • Type: String.
    • Source: Attribute.
    • Selector: Figure img.
    • Attribute: Alt.
    • Default: .
  • MediaPosition:
    • Type: String.
    • Default: Left.
  • MediaId:
    • Type: Number.
  • MediaUrl:
    • Type: String.
    • Source: Attribute.
    • Selector: Figure video,figure img.
    • Attribute: Src.
  • MediaLink:
    • Type: String.
  • LinkDestination:
    • Type: String.
  • LinkTarget:
    • Type: String.
    • Source: Attribute.
    • Selector: Figure a.
    • Attribute: Target.
  • Href:
    • Type: String.
    • Source: Attribute.
    • Selector: Figure a.
    • Attribute: Href.
  • Rel:
    • Type: String.
    • Source: Attribute.
    • Selector: Figure a.
    • Attribute: Rel.
  • LinkClass:
    • Type: String.
    • Source: Attribute.
    • Selector: Figure a.
    • Attribute: Class.
  • MediaType:
    • Type: String.
  • MediaWidth:
    • Type: Number.
    • Default: 50.
  • IsStackedOnMobile:
    • Type: Boolean.
    • Default: True.
  • VerticalAlignment:
    • Type: String.
  • ImageFill:
    • Type: Boolean.
  • FocalPoint:
    • Type: Object.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Align: wide, full,
  • Html: False.
  • __experimentalColor: gradients: True. linkColor: True.

Transforms

Optional. Type: Array.

Transforms provide rules for what a block can be transformed from and what it can be transformed to.

Documentation

Transforms to: image, video,


Missing

Your site doesn’t include support for this block.

Category: Text.

Source: View source on Github

CSS Class: wp-some-class

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • OriginalName:
    • Type: String.
  • OriginalUndelimitedContent:
    • Type: String.
  • OriginalContent:
    • Type: String.
    • Source: Html.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • ClassName: False.
  • CustomClassName: False.
  • Inserter: False.
  • Html: False.
  • Reusable: False.

More

Content before this block will be shown in the excerpt on your archives page.

Category: Design.

Source: View source on Github

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • CustomText:
    • Type: String.
  • NoTeaser:
    • Type: Boolean.
    • Default: False.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • CustomClassName: False.
  • ClassName: False.
  • Html: False.
  • Multiple: False.

Navigation-link

Add a page, link, or another item to your navigation.

Category: Design.

Source: View source on Github

Block Grammar & Markup

Parent

Optional. Type: Array.

Blocks are able to be inserted into blocks that use InnerBlocks as nested content. Setting parent lets a block require that it is only available when nested within the specified blocks.

Documentation

core/navigation

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Label:
    • Type: String.
  • Nofollow:
    • Type: Boolean.
    • Default: False.
  • Type:
    • Type: String.
  • Description:
    • Type: String.
  • Id:
    • Type: Number.
  • OpensInNewTab:
    • Type: Boolean.
    • Default: False.
  • Url:
    • Type: String.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Reusable: False.
  • Html: False.
  • LightBlockWrapper: True.

Navigation

Add a navigation block to your site.

Category: Design.

Source: View source on Github

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Orientation:
    • Type: String.
  • ClassName:
    • Type: String.
  • TextColor:
    • Type: String.
  • CustomTextColor:
    • Type: String.
  • RgbTextColor:
    • Type: String.
  • BackgroundColor:
    • Type: String.
  • CustomBackgroundColor:
    • Type: String.
  • RgbBackgroundColor:
    • Type: String.
  • FontSize:
    • Type: String.
  • CustomFontSize:
    • Type: Number.
  • ItemsJustification:
    • Type: String.
  • ShowSubmenuIcon:
    • Type: Boolean.
    • Default: True.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Align: wide, full,
  • Anchor: True.
  • Html: False.
  • Inserter: True.
  • LightBlockWrapper: True.

Nextpage

Separate your content into a multi-page experience.

Category: Design.

Source: View source on Github

Block Grammar & Markup

Parent

Optional. Type: Array.

Blocks are able to be inserted into blocks that use InnerBlocks as nested content. Setting parent lets a block require that it is only available when nested within the specified blocks.

Documentation

core/post-content

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • CustomClassName: False.
  • ClassName: False.
  • Html: False.

Paragraph

Start with the building block of all narrative.

Category: Text.

Source: View source on Github

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Align:
    • Type: String.
  • Content:
    • Type: String.
    • Source: Html.
    • Selector: P.
    • Default: .
  • DropCap:
    • Type: Boolean.
    • Default: False.
  • Placeholder:
    • Type: String.
  • Direction:
    • Type: String.
    • Enum: ltr, rtl,

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • ClassName: False.
  • LightBlockWrapper: True.
  • __experimentalColor: linkColor: True.
  • __experimentalFontSize: True.
  • __experimentalLineHeight: True.
  • __experimentalFeatures: Typography: dropCap: True.
  • __experimentalSelector: P.
  • __unstablePasteTextInline: True.

Post-author

Category: Design.

Source: View source on Github

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Align:
    • Type: String.
  • AvatarSize:
    • Type: Number.
  • ShowAvatar:
    • Type: Boolean.
  • ShowBio:
    • Type: Boolean.
  • Byline:
    • Type: String.
  • BackgroundColor:
    • Type: String.
  • TextColor:
    • Type: String.
  • CustomBackgroundColor:
    • Type: String.
  • CustomTextColor:
    • Type: String.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Html: False.

Post-comments-count

Category: Design.

Source: View source on Github

Block Grammar & Markup

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Html: False.

Post-comments-form

Category: Design.

Source: View source on Github

Block Grammar & Markup

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Html: False.

Post-comments

Category: Design.

Source: View source on Github

Block Grammar & Markup

Post-content

Category: Design.

Source: View source on Github

Block Grammar & Markup

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Html: False.

Post-date

Category: Design.

Source: View source on Github

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Format:
    • Type: String.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Html: False.

Post-excerpt

Category: Design.

Source: View source on Github

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • WordCount:
    • Type: Number.
    • Default: 55.
  • MoreText:
    • Type: String.
  • ShowMoreOnNewLine:
    • Type: Boolean.
    • Default: True.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Html: False.

Post-featured-image

Category: Design.

Source: View source on Github

Block Grammar & Markup

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Html: False.

Post-tags

Category: Design.

Source: View source on Github

Block Grammar & Markup

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Html: False.

Post-title

Category: Design.

Source: View source on Github

Block Grammar & Markup

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Html: False.

Preformatted

Add text that respects your spacing and tabs, and also allows styling.

Category: Text.

Source: View source on Github

CSS Class: wp-block-preformatted

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Content:
    • Type: String.
    • Source: Html.
    • Selector: Pre.
    • Default: .
    • __unstablePreserveWhiteSpace: True.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • LightBlockWrapper: True.

Transforms

Optional. Type: Array.

Transforms provide rules for what a block can be transformed from and what it can be transformed to.

Documentation

Transforms from: paragraph,

Transforms to: code', 'core/paragraph, paragraph,


Pullquote

Give special visual emphasis to a quote from your text.

Category: Text.

Source: View source on Github

CSS Class: wp-block-pullquote

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • Value:
    • Type: String.
    • Source: Html.
    • Selector: Blockquote.
    • Multiline: P.
  • Citation:
    • Type: String.
    • Source: Html.
    • Selector: Cite.
    • Default: .
  • MainColor:
    • Type: String.
  • CustomMainColor:
    • Type: String.
  • TextColor:
    • Type: String.
  • CustomTextColor:
    • Type: String.

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Align: left, right, 2: wide, 3: full,

Query-loop

Category: Design.

Source: View source on Github

Block Grammar & Markup

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Reusable: False.
  • Html: False.

Query-pagination

Category: Design.

Source: View source on Github

Block Grammar & Markup

Supports

Optional. Type: Object.

Optional block extended support features.

Documentation

  • Reusable: False.
  • Html: False.

Query

Category: Design.

Source: View source on Github

Block Grammar & Markup

Attributes

Optional. Type: Object.

Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

Documentation

  • QueryId:
    • Type: Number.
  • Query:
    • Type: Object.
    • Default: perPage: 3, pages: 1, offset: 0,
      • categoryIds:

    Supports

    Optional. Type: Object.

    Optional block extended support features.

    Documentation

    • Html: False.

    Quote

    Give quoted text visual emphasis. "In quoting others, we cite ourselves." — Julio Cortázar

    Category: Text.

    Source: View source on Github

    Attributes

    Optional. Type: Object.

    Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

    Documentation

    • Value:
      • Type: String.
      • Source: Html.
      • Selector: Blockquote.
      • Multiline: P.
      • Default: .
    • Citation:
      • Type: String.
      • Source: Html.
      • Selector: Cite.
      • Default: .
    • Align:
      • Type: String.

    Rss

    Display entries from any RSS or Atom feed.

    Category: Widgets.

    Source: View source on Github

    Block Grammar & Markup

    Attributes

    Optional. Type: Object.

    Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

    Documentation

    • Align:
      • Type: String.
      • Enum: left, center, right, wide, full,
    • ClassName:
      • Type: String.
    • Columns:
      • Type: Number.
      • Default: 2.
    • BlockLayout:
      • Type: String.
      • Default: List.
    • FeedURL:
      • Type: String.
      • Default: .
    • ItemsToShow:
      • Type: Number.
      • Default: 5.
    • DisplayExcerpt:
      • Type: Boolean.
      • Default: False.
    • DisplayAuthor:
      • Type: Boolean.
      • Default: False.
    • DisplayDate:
      • Type: Boolean.
      • Default: False.
    • ExcerptLength:
      • Type: Number.
      • Default: 55.

    Supports

    Optional. Type: Object.

    Optional block extended support features.

    Documentation

    • Align: True.
    • Html: False.

    Search

    Help visitors find your content.

    Category: Widgets.

    Source: View source on Github

    Block Grammar & Markup

    Attributes

    Optional. Type: Object.

    Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

    Documentation

    • Align:
      • Type: String.
      • Enum: left, center, right, wide, full,
    • ClassName:
      • Type: String.
    • Label:
      • Type: String.
    • Placeholder:
      • Type: String.
      • Default: .
    • ButtonText:
      • Type: String.

    Supports

    Optional. Type: Object.

    Optional block extended support features.

    Documentation

    • Align: True.
    • Html: False.

    Separator

    Create a break between ideas or sections with a horizontal separator.

    Category: Design.

    Source: View source on Github

    CSS Class: wp-block-separator

    Block Grammar & Markup

    Attributes

    Optional. Type: Object.

    Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

    Documentation

    • Color:
      • Type: String.
    • CustomColor:
      • Type: String.

    Shortcode

    Insert additional custom elements with a WordPress shortcode.

    Category: Widgets.

    Source: View source on Github

    Block Grammar & Markup

    Attributes

    Optional. Type: Object.

    Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

    Documentation

    • Text:
      • Type: String.
      • Source: Html.

    Supports

    Optional. Type: Object.

    Optional block extended support features.

    Documentation

    • ClassName: False.
    • CustomClassName: False.
    • Html: False.

    Site-title

    Category: Design.

    Source: View source on Github

    Block Grammar & Markup

    Attributes

    Optional. Type: Object.

    Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

    Documentation

    • Level:
      • Type: Number.
      • Default: 1.
    • Align:
      • Type: String.

    Supports

    Optional. Type: Object.

    Optional block extended support features.

    Documentation

    • Html: False.
    • LightBlockWrapper: True.

    Social-link

    Display an icon linking to a social media profile or website.

    Category: Widgets.

    Source: View source on Github

    Block Grammar & Markup

    Parent

    Optional. Type: Array.

    Blocks are able to be inserted into blocks that use InnerBlocks as nested content. Setting parent lets a block require that it is only available when nested within the specified blocks.

    Documentation

    core/social-links

    Attributes

    Optional. Type: Object.

    Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

    Documentation

    • Url:
      • Type: String.
    • Service:
      • Type: String.
    • Label:
      • Type: String.

    Supports

    Optional. Type: Object.

    Optional block extended support features.

    Documentation

    • Reusable: False.
    • Html: False.
    • LightBlockWrapper: True.

    Social-links

    Display icons linking to your social media profiles or websites.

    Category: Widgets.

    Source: View source on Github

    CSS Class: wp-block-social-links

    Block Grammar & Markup

    Supports

    Optional. Type: Object.

    Optional block extended support features.

    Documentation

    • Align: left, center, 2: right,
    • LightBlockWrapper: True.

    Spacer

    Add white space between blocks and customize its height.

    Category: Design.

    Source: View source on Github

    CSS Class: wp-block-spacer

    Block Grammar & Markup

    Attributes

    Optional. Type: Object.

    Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

    Documentation

    • Height:
      • Type: Number.
      • Default: 100.

    Subhead

    This block is deprecated. Please use the Paragraph block instead.

    Category: Text.

    Source: View source on Github

    Attributes

    Optional. Type: Object.

    Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

    Documentation

    • Align:
      • Type: String.
    • Content:
      • Type: String.
      • Source: Html.
      • Selector: P.

    Supports

    Optional. Type: Object.

    Optional block extended support features.

    Documentation

    • Inserter: False.
    • Multiple: False.

    Transforms

    Optional. Type: Array.

    Transforms provide rules for what a block can be transformed from and what it can be transformed to.

    Documentation

    Transforms from: paragraph,

    Transforms to: paragraph,


    Table

    Insert a table — perfect for sharing charts and data.

    Category: Text.

    Source: View source on Github

    CSS Class: wp-block-table

    Block Grammar & Markup

    Attributes

    Optional. Type: Object.

    Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

    Documentation

    • HasFixedLayout:
      • Type: Boolean.
      • Default: False.
    • BackgroundColor:
      • Type: String.
    • Caption:
      • Type: String.
      • Source: Html.
      • Selector: Figcaption.
      • Default: .
    • Head:
      • Type: Array.
      • Default:
      • Source: Query.
      • Selector: Thead tr.
      • Query:
        • cells:
          • type: array.
          • default: [].
          • source: query.
          • selector: td,th.
          • query:
            • content:
              • type: string
              • source: html
            • tag:
              • type: string
              • default: td
              • source: tag
            • scope:
              • type: string
              • source: attribute
              • attribute: scope
            • align:
              • type: string
              • source: attribute
              • attribute: data-align
    • Body:
      • Type: Array.
      • Default:
      • Source: Query.
      • Selector: Tbody tr.
      • Query:
        • cells:
          • type: array.
          • default: [].
          • source: query.
          • selector: td,th.
          • query:
            • content:
              • type: string
              • source: html
            • tag:
              • type: string
              • default: td
              • source: tag
            • scope:
              • type: string
              • source: attribute
              • attribute: scope
            • align:
              • type: string
              • source: attribute
              • attribute: data-align
    • Foot:
      • Type: Array.
      • Default:
      • Source: Query.
      • Selector: Tfoot tr.
      • Query:
        • cells:
          • type: array.
          • default: [].
          • source: query.
          • selector: td,th.
          • query:
            • content:
              • type: string
              • source: html
            • tag:
              • type: string
              • default: td
              • source: tag
            • scope:
              • type: string
              • source: attribute
              • attribute: scope
            • align:
              • type: string
              • source: attribute
              • attribute: data-align

    Supports

    Optional. Type: Object.

    Optional block extended support features.

    Documentation

    • Align: True.

    Tag-cloud

    A cloud of your most used tags.

    Category: Widgets.

    Source: View source on Github

    Block Grammar & Markup

    Attributes

    Optional. Type: Object.

    Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

    Documentation

    • Align:
      • Type: String.
      • Enum: left, center, right, wide, full,
    • ClassName:
      • Type: String.
    • Taxonomy:
      • Type: String.
      • Default: Post_tag.
    • ShowTagCounts:
      • Type: Boolean.
      • Default: False.

    Supports

    Optional. Type: Object.

    Optional block extended support features.

    Documentation

    • Html: False.
    • Align: True.

    Verse

    Insert poetry. Use special spacing formats. Or quote song lyrics.

    Category: Text.

    Source: View source on Github

    CSS Class: wp-block-verse

    Block Grammar & Markup

    Attributes

    Optional. Type: Object.

    Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

    Documentation

    • Content:
      • Type: String.
      • Source: Html.
      • Selector: Pre.
      • Default: .
      • __unstablePreserveWhiteSpace: True.
    • TextAlign:
      • Type: String.

    Supports

    Optional. Type: Object.

    Optional block extended support features.

    Documentation

    • LightBlockWrapper: True.

    Transforms

    Optional. Type: Array.

    Transforms provide rules for what a block can be transformed from and what it can be transformed to.

    Documentation

    Transforms from: paragraph,

    Transforms to: paragraph,


    Video

    Embed a video from your media library or upload a new one.

    Category: Media.

    Source: View source on Github

    CSS Class: wp-block-video

    Block Grammar & Markup

    Attributes

    Optional. Type: Object.

    Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

    Documentation

    • Autoplay:
      • Type: Boolean.
      • Source: Attribute.
      • Selector: Video.
      • Attribute: Autoplay.
    • Caption:
      • Type: String.
      • Source: Html.
      • Selector: Figcaption.
    • Controls:
      • Type: Boolean.
      • Source: Attribute.
      • Selector: Video.
      • Attribute: Controls.
      • Default: True.
    • Id:
      • Type: Number.
    • Loop:
      • Type: Boolean.
      • Source: Attribute.
      • Selector: Video.
      • Attribute: Loop.
    • Muted:
      • Type: Boolean.
      • Source: Attribute.
      • Selector: Video.
      • Attribute: Muted.
    • Poster:
      • Type: String.
      • Source: Attribute.
      • Selector: Video.
      • Attribute: Poster.
    • Preload:
      • Type: String.
      • Source: Attribute.
      • Selector: Video.
      • Attribute: Preload.
      • Default: Metadata.
    • Src:
      • Type: String.
      • Source: Attribute.
      • Selector: Video.
      • Attribute: Src.
    • PlaysInline:
      • Type: Boolean.
      • Source: Attribute.
      • Selector: Video.
      • Attribute: Playsinline.

    Supports

    Optional. Type: Object.

    Optional block extended support features.

    Documentation

    • Align: True.
    • LightBlockWrapper: True.

    Widget-area

    A widget area container.

    Category: Widgets.

    Source: View source on Github

    Block Grammar & Markup

    Attributes

    Optional. Type: Object.

    Attributes provide the structured data needs of a block. They can exist in different forms when they are serialized, but they are declared together under a common interface.

    Documentation

    • Id:
      • Type: String.
    • Name:
      • Type: String.

    Supports

    Optional. Type: Object.

    Optional block extended support features.

    Documentation

    • Html: False.
    • Inserter: False.
    • CustomClassName: False.
    • __experimentalToolbar: False.