This page lists the blocks included in the block-library package.

  • Items marked with a strikeout (strikeout) are explicitly disabled.
  • Blocks marked with Experimental: true are only available when Gutenberg is active.
  • Blocks marked with Experimental: fse are only available in the Site Editor.

Displays a foldable layout that groups content in collapsible sections. (Source)

  • Name: core/accordion
  • Category: design
  • Allowed Blocks: core/accordion-item
  • Supports: align (full, wide), anchor, ariaLabel, background (backgroundImage, backgroundSize), color (background, gradients, text), contentRole, interactivity, layout, listView, shadow, spacing (blockGap, margin, padding), typography (fontSize, lineHeight), html
  • Attributes: autoclose, headingLevel, iconPosition, levelOptions, showIcon

Displays a heading that toggles the accordion panel. (Source)

  • Name: core/accordion-heading
  • Category: design
  • Parent: core/accordion-item
  • Supports: anchor, color (background, gradients, text), interactivity, shadow, spacing (padding), typography (fontSize), align, lock, visibility
  • Attributes: iconPosition, level, openByDefault, showIcon, title

Wraps the heading and panel in one unit. (Source)

  • Name: core/accordion-item
  • Category: design
  • Parent: core/accordion
  • Allowed Blocks: core/accordion-heading, core/accordion-panel
  • Supports: color (background, gradients, text), contentRole, interactivity, layout (allowEditing), shadow, spacing (blockGap, margin), typography (fontSize, lineHeight), html
  • Attributes: openByDefault

Contains the hidden or revealed content beneath the heading. (Source)

  • Name: core/accordion-panel
  • Category: design
  • Parent: core/accordion-item
  • Supports: allowedBlocks, color (background, gradients, text), contentRole, interactivity, layout (allowEditing), shadow, spacing (blockGap, padding), typography (fontSize, lineHeight), html, lock, visibility
  • Attributes: templateLock

Display a date archive of your posts. (Source)

  • Name: core/archives
  • Category: widgets
  • Supports: align, anchor, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight), html
  • Attributes: displayAsDropdown, showLabel, showPostCounts, type

Embed a simple audio player. (Source)

  • Name: core/audio
  • Category: media
  • Supports: align, anchor, interactivity (clientNavigation), spacing (margin, padding)
  • Attributes: autoplay, blob, caption, id, loop, preload, src

Add a user’s avatar. (Source)

  • Name: core/avatar
  • Category: theme
  • Supports: align, anchor, color (background, text), filter (duotone), interactivity (clientNavigation), spacing (margin, padding), alignWide, html
  • Attributes: isLink, linkTarget, size, userId

Reuse this design across your site. (Source)

  • Name: core/block
  • Category: reusable
  • Supports: interactivity (clientNavigation), customCSS, customClassName, html, inserter, renaming
  • Attributes: content, ref

Display a breadcrumb trail showing the path to the current page. (Source)

  • Name: core/breadcrumbs
  • Category: theme
  • Supports: align (full, wide), anchor, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight), html
  • Attributes: prefersTaxonomy, separator, showCurrentItem, showHomeItem, showOnHomePage

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

  • Name: core/button
  • Category: design
  • Parent: core/buttons
  • Supports: anchor, color (background, gradients, text), dimensions (width), interactivity (clientNavigation), shadow, spacing (padding), splitting, typography (fontSize, lineHeight, textAlign), alignWide, align, reusable
  • Attributes: backgroundColor, gradient, linkTarget, placeholder, rel, tagName, text, textColor, title, type, url

Prompt visitors to take action with a group of button-style links. (Source)

  • Name: core/buttons
  • Category: design
  • Allowed Blocks: core/button
  • Supports: align (full, wide), anchor, color (background, gradients, text), contentRole, interactivity (clientNavigation), layout (default, allowInheriting, allowSwitching), listView, spacing (blockGap, margin, padding), typography (fontSize, lineHeight), html

A calendar of your site’s posts. (Source)

  • Name: core/calendar
  • Category: widgets
  • Supports: align, anchor, color (background, link, text), interactivity (clientNavigation), typography (fontSize, lineHeight), html
  • Attributes: month, year

Display a list of all terms of a given taxonomy. (Source)

  • Name: core/categories
  • Category: widgets
  • Supports: align, anchor, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight), html
  • Attributes: displayAsDropdown, label, showEmpty, showHierarchy, showLabel, showOnlyTopLevel, showPostCounts, taxonomy

Display code snippets that respect your spacing and tabs. (Source)

  • Name: core/code
  • Category: text
  • Supports: align (wide), anchor, color (background, gradients, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight)
  • Attributes: content

A single column within a columns block. (Source)

  • Name: core/column
  • Category: design
  • Parent: core/columns
  • Supports: allowedBlocks, anchor, color (background, button, gradients, heading, link, text), interactivity (clientNavigation), layout, shadow, spacing (blockGap, padding), typography (fontSize, lineHeight), html, reusable
  • Attributes: templateLock, verticalAlignment, width

Display content in multiple columns, with blocks added to each column. (Source)

  • Name: core/columns
  • Category: design
  • Allowed Blocks: core/column
  • Supports: align (full, wide), anchor, color (background, button, gradients, heading, link, text), interactivity (clientNavigation), layout (default, allowEditing, allowInheriting, allowSwitching), shadow, spacing (blockGap, margin, padding), typography (fontSize, lineHeight), html
  • Attributes: isStackedOnMobile, templateLock, verticalAlignment

This block is deprecated. Please use the Avatar block instead. (Source)

  • Name: core/comment-author-avatar
  • Experimental: fse
  • Category: theme
  • Ancestor: core/comment-template
  • Supports: color (background, text), interactivity (clientNavigation), spacing (margin, padding), html, inserter
  • Attributes: height, width

Displays the name of the author of the comment. (Source)

  • Name: core/comment-author-name
  • Category: theme
  • Ancestor: core/comment-template
  • Supports: anchor, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight, textAlign), html
  • Attributes: isLink, linkTarget

Displays the contents of a comment. (Source)

  • Name: core/comment-content
  • Category: theme
  • Ancestor: core/comment-template
  • Supports: anchor, color (background, gradients, link, text), spacing (padding), typography (fontSize, lineHeight, textAlign), html

Displays the date on which the comment was posted. (Source)

  • Name: core/comment-date
  • Category: theme
  • Ancestor: core/comment-template
  • Supports: anchor, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight, textAlign), html
  • Attributes: format, isLink

Displays a link to edit the comment in the WordPress Dashboard. This link is only visible to users with the edit comment capability. (Source)

  • Name: core/comment-edit-link
  • Category: theme
  • Ancestor: core/comment-template
  • Supports: anchor, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight, textAlign), html
  • Attributes: linkTarget

Displays a link to reply to a comment. (Source)

  • Name: core/comment-reply-link
  • Category: theme
  • Ancestor: core/comment-template
  • Supports: anchor, color (background, gradients, link, text), spacing (margin, padding), typography (fontSize, lineHeight, textAlign), html

Contains the block elements used to display a comment, like the title, date, author, avatar and more. (Source)

  • Name: core/comment-template
  • Category: design
  • Parent: core/comments
  • Supports: align, anchor, interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight), html, reusable

An advanced block that allows displaying post comments using different visual configurations. (Source)

  • Name: core/comments
  • Category: theme
  • Supports: align (full, wide), anchor, color (background, gradients, heading, link, text), spacing (margin, padding), typography (fontSize, lineHeight), html
  • Attributes: legacy, tagName

Displays a paginated navigation to next/previous set of comments, when applicable. (Source)

  • Name: core/comments-pagination
  • Category: theme
  • Parent: core/comments
  • Allowed Blocks: core/comments-pagination-previous, core/comments-pagination-numbers, core/comments-pagination-next
  • Supports: align, anchor, color (background, gradients, link, text), interactivity (clientNavigation), layout (default, allowInheriting, allowSwitching), typography (fontSize, lineHeight), html, reusable
  • Attributes: paginationArrow

Displays the next comment’s page link. (Source)

  • Name: core/comments-pagination-next
  • Category: theme
  • Parent: core/comments-pagination
  • Supports: anchor, color (background, gradients, text), interactivity (clientNavigation), typography (fontSize, lineHeight), html, reusable
  • Attributes: label

Displays a list of page numbers for comments pagination. (Source)

  • Name: core/comments-pagination-numbers
  • Category: theme
  • Parent: core/comments-pagination
  • Supports: anchor, color (background, gradients, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight), html, reusable

Displays the previous comment’s page link. (Source)

  • Name: core/comments-pagination-previous
  • Category: theme
  • Parent: core/comments-pagination
  • Supports: anchor, color (background, gradients, text), interactivity (clientNavigation), typography (fontSize, lineHeight), html, reusable
  • Attributes: label

Displays a title with the number of comments. (Source)

  • Name: core/comments-title
  • Category: theme
  • Ancestor: core/comments
  • Supports: align, anchor, color (background, gradients, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight, textAlign), html
  • Attributes: level, levelOptions, showCommentsCount, showPostTitle

Add an image or video with a text overlay. (Source)

  • Name: core/cover
  • Category: media
  • Supports: align, allowedBlocks, anchor, color (heading, text, background, enableContrastChecker), dimensions (aspectRatio), filter (duotone), interactivity (clientNavigation), layout (allowJustification), shadow, spacing (blockGap, margin, padding), typography (fontSize, lineHeight), html
  • Attributes: alt, backgroundType, contentPosition, customGradient, customOverlayColor, dimRatio, focalPoint, gradient, hasParallax, id, isDark, isRepeated, isUserOverlayColor, minHeight, minHeightUnit, overlayColor, poster, sizeSlug, tagName, templateLock, url, useFeaturedImage

Hide and show additional content. (Source)

  • Name: core/details
  • Category: text
  • Supports: align (full, wide), allowedBlocks, anchor, color (background, gradients, link, text), interactivity (clientNavigation), layout (allowEditing), spacing (blockGap, margin, padding), typography (fontSize, lineHeight), html
  • Attributes: name, placeholder, showContent, summary

Add a block that displays content pulled from other sites, like Twitter or YouTube. (Source)

  • Name: core/embed
  • Category: embed
  • Supports: align, anchor, interactivity (clientNavigation), spacing (margin)
  • Attributes: allowResponsive, caption, previewable, providerNameSlug, responsive, type, url

Add a link to a downloadable file. (Source)

  • Name: core/file
  • Category: media
  • Supports: align, anchor, color (background, gradients, link, text), interactivity, spacing (margin, padding)
  • Attributes: blob, displayPreview, downloadButtonText, fileId, fileName, href, id, previewHeight, showDownloadButton, textLinkHref, textLinkTarget

Display footnotes added to the page. (Source)

  • Name: core/footnotes
  • Category: text
  • Supports: anchor, color (background, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight), html, inserter, multiple, reusable

A form. (Source)

  • Name: core/form
  • Experimental: true
  • Category: widgets
  • Allowed Blocks: core/paragraph, core/heading, core/form-input, core/form-submit-button, core/form-submission-notification, core/group, core/columns
  • Supports: anchor, color (background, gradients, link, text), spacing (margin, padding), typography (fontSize, lineHeight)
  • Attributes: action, email, method, submissionMethod

The basic building block for forms. (Source)

  • Name: core/form-input
  • Experimental: true
  • Category: widgets
  • Ancestor: core/form
  • Supports: anchor, spacing (margin), reusable
  • Attributes: inlineLabel, label, name, placeholder, required, type, value, visibilityPermissions

Provide a notification message after the form has been submitted. (Source)

  • Name: core/form-submission-notification
  • Experimental: true
  • Category: widgets
  • Ancestor: core/form
  • Attributes: type

A submission button for forms. (Source)

  • Name: core/form-submit-button
  • Experimental: true
  • Category: widgets
  • Ancestor: core/form
  • Allowed Blocks: core/buttons, core/button

Use the classic WordPress editor. (Source)

  • Name: core/freeform
  • Category: text
  • Supports: className, customCSS, customClassName, lock, renaming, reusable, visibility
  • Attributes: content

Display multiple images in a rich gallery. (Source)

  • Name: core/gallery
  • Category: media
  • Allowed Blocks: core/image
  • Supports: align, anchor, color (background, gradients, text), interactivity (clientNavigation), layout (default, allowEditing, allowInheriting, allowSwitching), listView, spacing (blockGap, margin, padding), units (em, px, rem, vh, vw), html
  • Attributes: allowResize, aspectRatio, caption, columns, fixedHeight, ids, imageCrop, images, linkTarget, linkTo, navigationButtonType, randomOrder, shortCodeTransforms, sizeSlug

Gather blocks in a layout container. (Source)

  • Name: core/group
  • Category: design
  • Supports: align (full, wide), allowedBlocks, anchor, ariaLabel, background (backgroundImage, backgroundSize, gradient), color (background, button, gradients, heading, link, text), dimensions (minHeight, minWidth), interactivity (clientNavigation), layout (allowSizingOnChildren), position (sticky), shadow, spacing (blockGap, margin, padding), typography (fontSize, lineHeight), html
  • Attributes: tagName, templateLock

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

  • Name: core/heading
  • Category: text
  • Supports: __unstablePasteTextInline, align (full, wide), anchor, className, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), splitting, typography (fitText, fontSize, lineHeight, textAlign)
  • Attributes: content, level, levelOptions, placeholder

Create a link that always points to the homepage of the site. Usually not necessary if there is already a site title link present in the header. (Source)

  • Name: core/home-link
  • Category: design
  • Parent: core/navigation
  • Supports: anchor, interactivity (clientNavigation), typography (fontSize, lineHeight), html, reusable
  • Attributes: label

Add custom HTML code and preview it as you edit. (Source)

  • Name: core/html
  • Category: widgets
  • Supports: interactivity (clientNavigation), className, customCSS, customClassName, html, visibility
  • Attributes: content

Insert an SVG icon. (Source)

  • Name: core/icon
  • Category: media
  • Supports: align (center, left, right), anchor, ariaLabel, color (background, text), dimensions (width), interactivity (clientNavigation), spacing (margin, padding), html
  • Attributes: icon

Insert an image to make a visual statement. (Source)

  • Name: core/image
  • Category: media
  • Supports: align (center, full, left, right, wide), anchor, color (background, text), filter (duotone), interactivity, shadow, spacing (margin)
  • Attributes: alt, aspectRatio, blob, caption, focalPoint, height, href, id, lightbox, linkClass, linkDestination, linkTarget, rel, scale, sizeSlug, title, url, width

Display a list of your most recent comments. (Source)

  • Name: core/latest-comments
  • Category: widgets
  • Supports: align, anchor, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight), html
  • Attributes: commentsToShow, displayAvatar, displayContent, displayDate

Display a list of your most recent posts. (Source)

  • Name: core/latest-posts
  • Category: widgets
  • Supports: align, anchor, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight), html
  • Attributes: addLinkToFeaturedImage, categories, columns, displayAuthor, displayFeaturedImage, displayPostContent, displayPostContentRadio, displayPostDate, excerptLength, featuredImageAlign, featuredImageSizeHeight, featuredImageSizeSlug, featuredImageSizeWidth, order, orderBy, postLayout, postsToShow, selectedAuthor

An organized collection of items displayed in a specific order. (Source)

  • Name: core/list
  • Category: text
  • Allowed Blocks: core/list-item
  • Supports: __unstablePasteTextInline, anchor, color (background, gradients, link, text), interactivity (clientNavigation), listView, spacing (margin, padding), typography (fontSize, lineHeight), html
  • Attributes: ordered, placeholder, reversed, start, type, values

An individual item within a list. (Source)

  • Name: core/list-item
  • Category: text
  • Parent: core/list
  • Allowed Blocks: core/list
  • Supports: anchor, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), splitting, typography (fontSize, lineHeight), className, html
  • Attributes: content, placeholder

Show login & logout links. (Source)

  • Name: core/loginout
  • Category: theme
  • Supports: anchor, className, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight)
  • Attributes: displayLoginAsForm, redirectToCurrent

Display mathematical notation using LaTeX. (Source)

  • Name: core/math
  • Category: text
  • Supports: anchor, color (background, gradients, text), spacing (margin, padding), typography (fontSize), html
  • Attributes: latex, mathML

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

  • Name: core/media-text
  • Category: media
  • Supports: align (full, wide), allowedBlocks, anchor, color (background, gradients, heading, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight), html
  • Attributes: align, focalPoint, href, imageFill, isStackedOnMobile, linkClass, linkDestination, linkTarget, mediaAlt, mediaId, mediaLink, mediaPosition, mediaSizeSlug, mediaType, mediaUrl, mediaWidth, rel, useFeaturedImage, verticalAlignment

Your site doesn’t include support for this block. (Source)

  • Name: core/missing
  • Category: text
  • Supports: interactivity (clientNavigation), className, customCSS, customClassName, html, inserter, lock, renaming, reusable, visibility
  • Attributes: originalContent, originalName, originalUndelimitedContent

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

  • Name: core/more
  • Category: design
  • Supports: interactivity (clientNavigation), className, customCSS, customClassName, html, multiple, visibility
  • Attributes: customText, noTeaser

A collection of blocks that allow visitors to get around your site. (Source)

  • Name: core/navigation
  • Category: theme
  • Allowed Blocks: core/navigation-link, core/search, core/social-links, core/page-list, core/spacer, core/home-link, core/icon, core/site-title, core/site-logo, core/navigation-submenu, core/loginout, core/buttons
  • Supports: align (full, wide), anchor, ariaLabel, contentRole, inserter, interactivity, layout (allowSizingOnChildren, default, allowInheriting, allowSwitching, allowVerticalAlignment), spacing (blockGap, units), typography (fontSize, lineHeight), html, renaming
  • Attributes: __unstableLocation, backgroundColor, customBackgroundColor, customOverlayBackgroundColor, customOverlayTextColor, customTextColor, hasIcon, icon, maxNestingLevel, overlay, overlayBackgroundColor, overlayMenu, overlayTextColor, ref, rgbBackgroundColor, rgbTextColor, showSubmenuIcon, submenuVisibility, templateLock, textColor

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

  • Name: core/navigation-link
  • Category: design
  • Parent: core/navigation
  • Allowed Blocks: core/navigation-link, core/navigation-submenu, core/page-list
  • Supports: anchor, interactivity (clientNavigation), typography (fontSize, lineHeight), html, renaming, reusable
  • Attributes: description, id, isTopLevelLink, kind, label, opensInNewTab, rel, title, type, url

A customizable button to close overlays. (Source)

  • Name: core/navigation-overlay-close
  • Category: design
  • Supports: color (background, text, gradients), spacing (padding), typography (fontSize, lineHeight)
  • Attributes: displayMode, text

Add a submenu to your navigation. (Source)

  • Name: core/navigation-submenu
  • Category: design
  • Parent: core/navigation
  • Supports: anchor, interactivity (clientNavigation), typography (fontSize, lineHeight), html, reusable
  • Attributes: description, id, isTopLevelItem, kind, label, opensInNewTab, rel, title, type, url

Separate your content into a multi-page experience. (Source)

  • Name: core/nextpage
  • Category: design
  • Parent: core/post-content
  • Supports: interactivity (clientNavigation), className, customCSS, customClassName, html, visibility

Display a list of all pages. (Source)

  • Name: core/page-list
  • Category: widgets
  • Allowed Blocks: core/page-list-item
  • Supports: anchor, color (background, gradients, link, text), contentRole, interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight), html, reusable
  • Attributes: isNested, parentPageID

Displays a page inside a list of all pages. (Source)

  • Name: core/page-list-item
  • Category: widgets
  • Parent: core/page-list
  • Supports: anchor, interactivity (clientNavigation), html, inserter, lock, reusable
  • Attributes: hasChildren, id, label, link, title

Start with the basic building block of all narrative. (Source)

  • Name: core/paragraph
  • Category: text
  • Supports: __unstablePasteTextInline, align (full, wide), anchor, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), splitting, typography (fitText, fontSize, lineHeight, textAlign, textColumns, textIndent), className
  • Attributes: content, direction, dropCap, placeholder

Show a block pattern. (Source)

  • Name: core/pattern
  • Category: theme
  • Supports: interactivity (clientNavigation), html, inserter, renaming, visibility
  • Attributes: slug

Embed a simple playlist. (Source)

  • Name: core/playlist
  • Experimental: true
  • Category: media
  • Allowed Blocks: core/playlist-track
  • Supports: align, anchor, color (background, gradients, link, text), interactivity, spacing (margin, padding)
  • Attributes: caption, currentTrack, order, showArtists, showImages, showNumbers, showTracklist, type

Playlist track. (Source)

  • Name: core/playlist-track
  • Experimental: true
  • Category: media
  • Parent: core/playlist
  • Supports: interactivity (clientNavigation), html, reusable
  • Attributes: album, artist, blob, id, image, length, src, title, type, uniqueId

This block is deprecated. Please use the Avatar block, the Author Name block, and the Author Biography block instead. (Source)

  • Name: core/post-author
  • Category: theme
  • Supports: anchor, color (background, gradients, link, text), filter (duotone), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight), html, inserter
  • Attributes: avatarSize, byline, isLink, linkTarget, showAvatar, showBio, textAlign

The author biography. (Source)

  • Name: core/post-author-biography
  • Category: theme
  • Supports: anchor, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight, textAlign)

The author name. (Source)

  • Name: core/post-author-name
  • Category: theme
  • Supports: anchor, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight, textAlign), html
  • Attributes: isLink, linkTarget

This block is deprecated. Please use the Comments block instead. (Source)

  • Name: core/post-comment
  • Experimental: fse
  • Category: theme
  • Allowed Blocks: core/avatar, core/comment-author-name, core/comment-content, core/comment-date, core/comment-edit-link, core/comment-reply-link
  • Supports: interactivity (clientNavigation), html, inserter
  • Attributes: commentId

Display a post’s comments count. (Source)

  • Name: core/post-comments-count
  • Category: theme
  • Supports: anchor, color (background, gradients, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight, textAlign), html

Display a post’s comments form. (Source)

  • Name: core/post-comments-form
  • Category: theme
  • Supports: anchor, color (background, gradients, heading, link, text), spacing (margin, padding), typography (fontSize, lineHeight, textAlign), html

Displays the link to the current post comments. (Source)

  • Name: core/post-comments-link
  • Category: theme
  • Supports: anchor, color (background, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight, textAlign), html

Displays the contents of a post or page. (Source)

  • Name: core/post-content
  • Category: theme
  • Supports: align (full, wide), anchor, background (backgroundImage, backgroundSize), color (background, gradients, heading, link, text), dimensions (minHeight), interactivity (clientNavigation), layout, spacing (blockGap, margin, padding), typography (fontSize, lineHeight), html
  • Attributes: tagName

Display a custom date. (Source)

  • Name: core/post-date
  • Category: theme
  • Supports: anchor, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight, textAlign), html
  • Attributes: datetime, format, isLink

Display the excerpt. (Source)

  • Name: core/post-excerpt
  • Category: theme
  • Supports: anchor, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight, textAlign, textColumns), html
  • Attributes: excerptLength, moreText, showMoreOnNewLine

Display a post’s featured image. (Source)

  • Name: core/post-featured-image
  • Category: theme
  • Supports: align (center, full, left, right, wide), anchor, color (background, text), filter (duotone), interactivity (clientNavigation), shadow, spacing (margin, padding), html
  • Attributes: aspectRatio, customGradient, customOverlayColor, dimRatio, gradient, height, isLink, linkTarget, overlayColor, rel, scale, sizeSlug, useFirstImageFromPost, width

Displays the next or previous post link that is adjacent to the current post. (Source)

  • Name: core/post-navigation-link
  • Category: theme
  • Supports: anchor, color (background, link, text), interactivity (clientNavigation), typography (fontSize, lineHeight, textAlign), html, reusable
  • Attributes: arrow, label, linkLabel, showTitle, taxonomy, type

Contains the block elements used to render a post, like the title, date, featured image, content or excerpt, and more. (Source)

  • Name: core/post-template
  • Category: theme
  • Ancestor: core/query
  • Supports: align (full, wide), anchor, color (background, gradients, link, text), interactivity (clientNavigation), layout, spacing (blockGap, margin, padding), typography (fontSize, lineHeight), html, reusable

Post terms. (Source)

  • Name: core/post-terms
  • Category: theme
  • Supports: anchor, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight, textAlign), html
  • Attributes: prefix, separator, suffix, term

Show minutes required to finish reading the post. Can also show a word count. (Source)

  • Name: core/post-time-to-read
  • Category: theme
  • Supports: anchor, color (background, gradients, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight, textAlign), html
  • Attributes: averageReadingSpeed, displayAsRange, displayMode

Displays the title of a post, page, or any other content-type. (Source)

  • Name: core/post-title
  • Category: theme
  • Supports: align (full, wide), anchor, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight, textAlign), html
  • Attributes: isLink, level, levelOptions, linkTarget, placeholder, rel

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

  • Name: core/preformatted
  • Category: text
  • Supports: anchor, color (background, gradients, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight)
  • Attributes: content

Give special visual emphasis to a quote from your text. (Source)

  • Name: core/pullquote
  • Category: text
  • Supports: align (full, left, right, wide), anchor, background (backgroundImage, backgroundSize), color (background, gradients, link, text), dimensions (minHeight), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight)
  • Attributes: citation, textAlign, value

An advanced block that allows displaying post types based on different query parameters and visual configurations. (Source)

  • Name: core/query
  • Category: theme
  • Supports: align (full, wide), anchor, interactivity, layout, html
  • Attributes: enhancedPagination, namespace, query, queryId, tagName

Contains the block elements used to render content when no query results are found. (Source)

  • Name: core/query-no-results
  • Category: theme
  • Ancestor: core/query
  • Supports: align, anchor, color (background, gradients, link, text), interactivity (clientNavigation), typography (fontSize, lineHeight), html, reusable

Displays a paginated navigation to next/previous set of posts, when applicable. (Source)

  • Name: core/query-pagination
  • Category: theme
  • Ancestor: core/query
  • Allowed Blocks: core/query-pagination-previous, core/query-pagination-numbers, core/query-pagination-next
  • Supports: align, anchor, color (background, gradients, link, text), interactivity (clientNavigation), layout (default, allowInheriting, allowSwitching), typography (fontSize, lineHeight), html, reusable
  • Attributes: paginationArrow, showLabel

Displays the next posts page link. (Source)

  • Name: core/query-pagination-next
  • Category: theme
  • Parent: core/query-pagination
  • Supports: anchor, color (background, gradients, text), interactivity (clientNavigation), typography (fontSize, lineHeight), html, reusable
  • Attributes: label

Displays a list of page numbers for pagination. (Source)

  • Name: core/query-pagination-numbers
  • Category: theme
  • Parent: core/query-pagination
  • Supports: anchor, color (background, gradients, text), interactivity (clientNavigation), typography (fontSize, lineHeight), html, reusable
  • Attributes: midSize

Displays the previous posts page link. (Source)

  • Name: core/query-pagination-previous
  • Category: theme
  • Parent: core/query-pagination
  • Supports: anchor, color (background, gradients, text), interactivity (clientNavigation), typography (fontSize, lineHeight), html, reusable
  • Attributes: label

Display the query title. (Source)

  • Name: core/query-title
  • Category: theme
  • Supports: align (full, wide), anchor, color (background, gradients, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight, textAlign), html
  • Attributes: level, levelOptions, showPrefix, showSearchTerm, type

Display the total number of results in a query. (Source)

  • Name: core/query-total
  • Category: theme
  • Ancestor: core/query
  • Supports: align (full, wide), anchor, color (background, gradients, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight), html
  • Attributes: displayType

Give quoted text visual emphasis. “In quoting others, we cite ourselves.” — Julio Cortázar (Source)

  • Name: core/quote
  • Category: text
  • Supports: align (full, left, right, wide), allowedBlocks, anchor, background (backgroundImage, backgroundSize), color (background, gradients, heading, link, text), dimensions (minHeight), interactivity (clientNavigation), layout (allowEditing), spacing (blockGap, margin, padding), typography (fontSize, lineHeight), html
  • Attributes: citation, textAlign, value

Displays the link of a post, page, or any other content-type. (Source)

  • Name: core/read-more
  • Category: theme
  • Supports: anchor, color (background, gradients, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight), html
  • Attributes: content, linkTarget

Display entries from any RSS or Atom feed. (Source)

  • Name: core/rss
  • Category: widgets
  • Supports: align, anchor, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), html
  • Attributes: blockLayout, columns, displayAuthor, displayDate, displayExcerpt, excerptLength, feedURL, itemsToShow, openInNewTab, rel

Help visitors find your content. (Source)

  • Name: core/search
  • Category: widgets
  • Supports: align (center, left, right), anchor, color (background, gradients, text), interactivity, spacing (margin), typography (fontSize, lineHeight), html
  • Attributes: buttonPosition, buttonText, buttonUseIcon, label, placeholder, query, showLabel, width, widthUnit

Create a break between ideas or sections with a horizontal separator. (Source)

  • Name: core/separator
  • Category: design
  • Supports: align (center, full, wide), anchor, color (background, gradients, enableContrastChecker, text), interactivity (clientNavigation), spacing (margin)
  • Attributes: opacity, tagName

Insert additional custom elements with a WordPress shortcode. (Source)

  • Name: core/shortcode
  • Category: widgets
  • Supports: className, customCSS, customClassName, html, visibility
  • Attributes: text

Display an image to represent this site. Update this block and the changes apply everywhere. (Source)

  • Name: core/site-logo
  • Category: theme
  • Supports: align, anchor, color (background, text), filter (duotone), interactivity (clientNavigation), spacing (margin, padding), alignWide, html
  • Attributes: isLink, linkTarget, shouldSyncIcon, width

Describe in a few words what this site is about. This is important for search results, sharing on social media, and gives overall clarity to visitors. (Source)

  • Name: core/site-tagline
  • Category: theme
  • Supports: align (full, wide), anchor, color (background, gradients, text), contentRole, interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight, textAlign), html
  • Attributes: level, levelOptions

Displays the name of this site. Update the block, and the changes apply everywhere it’s used. This will also appear in the browser title bar and in search results. (Source)

  • Name: core/site-title
  • Category: theme
  • Supports: align (full, wide), anchor, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight, textAlign), html
  • Attributes: isLink, level, levelOptions, linkTarget

Display an icon linking to a social profile or site. (Source)

  • Name: core/social-link
  • Category: widgets
  • Parent: core/social-links
  • Supports: anchor, interactivity (clientNavigation), html, reusable
  • Attributes: label, rel, service, url

Display icons linking to your social profiles or sites. (Source)

  • Name: core/social-links
  • Category: widgets
  • Allowed Blocks: core/social-link
  • Supports: align (center, left, right), anchor, color (background, gradients, enableContrastChecker, text), contentRole, interactivity (clientNavigation), layout (default, allowInheriting, allowSwitching, allowVerticalAlignment), listView, spacing (blockGap, margin, padding, units), html
  • Attributes: customIconBackgroundColor, customIconColor, iconBackgroundColor, iconBackgroundColorValue, iconColor, iconColorValue, openInNewTab, showLabels, size

Add white space between blocks and customize its height. (Source)

  • Name: core/spacer
  • Category: design
  • Supports: anchor, interactivity (clientNavigation), spacing (margin)
  • Attributes: height, width

A single tab button in the tab list. (Source)

  • Name: core/tab
  • Experimental: true
  • Category: design
  • Parent: core/tab-list
  • Supports: color (background, text), spacing (padding), typography (fontSize, textAlign), html, lock, reusable, visibility

Display the tab buttons for a tabbed interface. (Source)

  • Name: core/tab-list
  • Experimental: true
  • Category: design
  • Parent: core/tabs
  • Allowed Blocks: core/tab
  • Supports: color (background, text), dimensions (aspectRatio, height, minHeight, width), layout (allowJustification, allowOrientation, allowVerticalAlignment, default, allowSwitching), spacing (blockGap, margin, padding), typography (fontSize), html, lock, reusable, visibility

Content for a tab in a tabbed interface. (Source)

  • Name: core/tab-panel
  • Experimental: true
  • Category: design
  • Parent: core/tab-panels
  • Supports: anchor, color (background, text), layout, renaming, spacing (blockGap, padding, margin), typography (fontSize), html, reusable, visibility
  • Attributes: label

Container for tab panel content in a tabbed interface. (Source)

  • Name: core/tab-panels
  • Experimental: true
  • Category: design
  • Parent: core/tabs
  • Allowed Blocks: core/tab-panel
  • Supports: color (background, heading, link, text), dimensions (aspectRatio, height, minHeight, width), layout (allowJustification, default, allowOrientation, allowSizingOnChildren, allowSwitching, allowVerticalAlignment), spacing (margin, padding, blockGap), typography (fontSize), anchor, html, lock, reusable, visibility

Create structured content in rows and columns to display information. (Source)

  • Name: core/table
  • Category: text
  • Supports: align, anchor, color (background, gradients, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight)
  • Attributes: body, caption, foot, hasFixedLayout, head

Summarize your post with a list of headings. Add HTML anchors to Heading blocks to link them here. (Source)

  • Name: core/table-of-contents
  • Experimental: true
  • Category: design
  • Supports: anchor, ariaLabel, color (background, gradients, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight), html
  • Attributes: headings, maxLevel, onlyIncludeCurrentPage, ordered

Display content in a tabbed interface to help users navigate detailed content with ease. (Source)

  • Name: core/tabs
  • Experimental: true
  • Category: design
  • Allowed Blocks: core/tab-list, core/tab-panels
  • Supports: align, anchor, color (background, text), interactivity, layout (allowJustification, allowOrientation, allowSizingOnChildren, allowVerticalAlignment, default, allowSwitching), renaming, spacing (blockGap, margin, padding), typography (fontSize), html
  • Attributes: activeTabIndex, editorActiveTabIndex

A cloud of popular keywords, each sized by how often it appears. (Source)

  • Name: core/tag-cloud
  • Category: widgets
  • Supports: align, anchor, interactivity (clientNavigation), spacing (margin, padding), typography (lineHeight), html
  • Attributes: largestFontSize, numberOfTags, showTagCounts, smallestFontSize, taxonomy

Edit the different global regions of your site, like the header, footer, sidebar, or create your own. (Source)

  • Name: core/template-part
  • Category: theme
  • Supports: align, interactivity (clientNavigation), html, renaming, reusable
  • Attributes: area, slug, tagName, theme

Displays the post count of a taxonomy term. (Source)

  • Name: core/term-count
  • Category: theme
  • Supports: anchor, color (background, gradients, text), interactivity (clientNavigation), spacing (padding), typography (fontSize, lineHeight), html
  • Attributes: bracketType

Display the description of categories, tags and custom taxonomies when viewing an archive. (Source)

  • Name: core/term-description
  • Category: theme
  • Supports: align (full, wide), anchor, color (background, link, text), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight, textAlign), html

Displays the name of a taxonomy term. (Source)

  • Name: core/term-name
  • Category: theme
  • Supports: align (full, wide), anchor, color (background, gradients, link, text), interactivity (clientNavigation), spacing (padding), typography (fontSize, lineHeight), html
  • Attributes: isLink, level, levelOptions, textAlign

Contains the block elements used to render a taxonomy term, like the name, description, and more. (Source)

  • Name: core/term-template
  • Category: theme
  • Ancestor: core/terms-query
  • Supports: align (full, wide), anchor, color (background, gradients, link, text), interactivity (clientNavigation), layout, spacing (blockGap, margin, padding), typography (fontSize, lineHeight), html, reusable

An advanced block that allows displaying taxonomy terms based on different query parameters and visual configurations. (Source)

  • Name: core/terms-query
  • Category: theme
  • Supports: align (full, wide), anchor, interactivity, layout, html
  • Attributes: tagName, termQuery

This block is deprecated. Please use the Columns block instead. (Source)

  • Name: core/text-columns
  • Category: design
  • Supports: interactivity (clientNavigation), inserter
  • Attributes: columns, content, width

Insert poetry. Use special spacing formats. Or quote song lyrics. (Source)

  • Name: core/verse
  • Category: text
  • Supports: anchor, background (backgroundImage, backgroundSize), color (background, gradients, link, text), dimensions (minHeight), interactivity (clientNavigation), spacing (margin, padding), typography (fontSize, lineHeight, textAlign)
  • Attributes: content

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

  • Name: core/video
  • Category: media
  • Supports: align, anchor, interactivity (clientNavigation), spacing (margin, padding)
  • Attributes: autoplay, blob, caption, controls, id, loop, muted, playsInline, poster, preload, src, tracks