Core Blocks Reference Edit

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

Items marked with a strikeout (strikeout) are explicitly disabled.

Archives Archives

Display a monthly archive of your posts. (Source)

  • Name: core/archives
  • Category: widgets
  • Supports: align, html
  • Attributes: displayAsDropdown, showPostCounts

Top ↑

Audio Audio

Embed a simple audio player. (Source)

  • Name: core/audio
  • Category: media
  • Supports: align, anchor
  • Attributes: autoplay, caption, id, loop, preload, src

Top ↑

Reusable block Reusable block

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

  • Name: core/block
  • Category: reusable
  • Supports: customClassName, html, inserter
  • Attributes: ref

Top ↑

Button Button

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

  • Name: core/button
  • Category: design
  • Supports: align, anchor, color (background, gradients, text), spacing (padding), typography (fontSize), alignWide, reusable
  • Attributes: backgroundColor, gradient, linkTarget, placeholder, rel, text, textColor, title, url, width

Top ↑

Buttons Buttons

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

  • Name: core/buttons
  • Category: design
  • Supports: align (full, wide), anchor, spacing (blockGap, margin)
  • Attributes:

Top ↑

Calendar Calendar

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

  • Name: core/calendar
  • Category: widgets
  • Supports: align
  • Attributes: month, year

Top ↑

Categories Categories

Display a list of all categories. (Source)

  • Name: core/categories
  • Category: widgets
  • Supports: align, html
  • Attributes: displayAsDropdown, showHierarchy, showOnlyTopLevel, showPostCounts

Top ↑

Code Code

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

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

Top ↑

Column Column

A single column within a columns block. (Source)

  • Name: core/column
  • Category: text
  • Supports: anchor, color (background, gradients, link, text), spacing (padding), html, reusable
  • Attributes: allowedBlocks, templateLock, verticalAlignment, width

Top ↑

Columns Columns

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

  • Name: core/columns
  • Category: design
  • Supports: align (full, wide), anchor, color (background, gradients, link, text), spacing (blockGap, margin, padding), html
  • Attributes: isStackedOnMobile, verticalAlignment

Top ↑

Comment Author Avatar Comment Author Avatar

Add the avatar of this comment’s author. (Source)

  • Name: core/comment-author-avatar
  • Category: theme
  • Supports: color (background, text), spacing (margin, padding), html
  • Attributes: height, width

Top ↑

Comment Author Name Comment Author Name

Add the author name of this comment. (Source)

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

Top ↑

Comment Content Comment Content

Displays the contents of a comment. (Source)

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

Top ↑

Comment Date Comment Date

Add the date of this comment. (Source)

  • Name: core/comment-date
  • Category: theme
  • Supports: color (background, gradients, link, text), typography (fontSize, lineHeight), html
  • Attributes: format, isLink

Top ↑

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
  • Supports: color (background, gradients, link, text), typography (fontSize, lineHeight), html
  • Attributes: linkTarget, textAlign

Top ↑

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

  • Name: core/comment-reply-link
  • Category: theme
  • Supports: color (background, gradients, link, text), typography (fontSize, lineHeight), html
  • Attributes: textAlign

Top ↑

Comment Template Comment Template

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

  • Name: core/comment-template
  • Category: design
  • Supports: align, html, reusable
  • Attributes:

Top ↑

Comments Pagination Comments Pagination

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

  • Name: core/comments-pagination
  • Category: theme
  • Supports: align, color (background, gradients, link, text), html, reusable
  • Attributes: paginationArrow

Top ↑

Next Page Next Page

Displays the next comments page link. (Source)

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

Top ↑

Page Numbers Page Numbers

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

  • Name: core/comments-pagination-numbers
  • Category: theme
  • Supports: html, reusable
  • Attributes:

Top ↑

Previous Page Previous Page

Displays the previous comments page link. (Source)

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

Top ↑

Comments Query Loop Comments Query Loop

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

  • Name: core/comments-query-loop
  • Category: theme
  • Supports: align (full, wide), color (background, gradients, link, text), html
  • Attributes: perPage, tagName

Top ↑

Cover Cover

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

  • Name: core/cover
  • Category: media
  • Supports: align, anchor, color (background, text), spacing (padding), html
  • Attributes: allowedBlocks, alt, backgroundType, contentPosition, customGradient, customOverlayColor, dimRatio, focalPoint, gradient, hasParallax, id, isDark, isRepeated, minHeight, minHeightUnit, overlayColor, templateLock, url

Top ↑

Embed Embed

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

  • Name: core/embed
  • Category: embed
  • Supports: align
  • Attributes: allowResponsive, caption, previewable, providerNameSlug, responsive, type, url

Top ↑

File File

Add a link to a downloadable file. (Source)

  • Name: core/file
  • Category: media
  • Supports: align, anchor
  • Attributes: displayPreview, downloadButtonText, fileId, fileName, href, id, previewHeight, showDownloadButton, textLinkHref, textLinkTarget

Top ↑

Classic Classic

Use the classic WordPress editor. (Source)

  • Name: core/freeform
  • Category: text
  • Supports: className, customClassName, reusable
  • Attributes: content

Top ↑

Display multiple images in a rich gallery. (Source)

  • Name: core/gallery
  • Category: media
  • Supports: align, anchor
  • Attributes: allowResize, caption, columns, fixedHeight, ids, imageCrop, images, linkTarget, linkTo, shortCodeTransforms, sizeSlug

Top ↑

Group Group

Combine blocks into a group. (Source)

  • Name: core/group
  • Category: design
  • Supports: align (full, wide), anchor, color (background, gradients, link, text), spacing (blockGap, padding), typography (fontSize, lineHeight), html
  • Attributes: tagName, templateLock

Top ↑

Heading Heading

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, color (background, link, text), spacing (margin), typography (fontSize, lineHeight), className
  • Attributes: content, level, placeholder, textAlign

Top ↑

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
  • Supports: html, reusable
  • Attributes: label

Top ↑

Custom HTML Custom HTML

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

  • Name: core/html
  • Category: widgets
  • Supports: className, customClassName, html
  • Attributes: content

Top ↑

Image Image

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

  • Name: core/image
  • Category: media
  • Supports: anchor, color (background, text)
  • Attributes: align, alt, caption, height, href, id, linkClass, linkDestination, linkTarget, rel, sizeSlug, title, url, width

Top ↑

Latest Comments Latest Comments

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

  • Name: core/latest-comments
  • Category: widgets
  • Supports: align, html
  • Attributes: commentsToShow, displayAvatar, displayDate, displayExcerpt

Top ↑

Latest Posts Latest Posts

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

  • Name: core/latest-posts
  • Category: widgets
  • Supports: align, html
  • Attributes: addLinkToFeaturedImage, categories, columns, displayAuthor, displayFeaturedImage, displayPostContent, displayPostContentRadio, displayPostDate, excerptLength, featuredImageAlign, featuredImageSizeHeight, featuredImageSizeSlug, featuredImageSizeWidth, order, orderBy, postLayout, postsToShow, selectedAuthor

Top ↑

List List

Create a bulleted or numbered list. (Source)

  • Name: core/list
  • Category: text
  • Supports: __unstablePasteTextInline, anchor, color (background, gradients, link, text), typography (fontSize, lineHeight), className
  • Attributes: ordered, placeholder, reversed, start, type, values

Top ↑

Login/out Login/out

Show login & logout links. (Source)

  • Name: core/loginout
  • Category: theme
  • Supports: className, typography (fontSize)
  • Attributes: displayLoginAsForm, redirectToCurrent

Top ↑

Media & Text Media & Text

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

  • Name: core/media-text
  • Category: media
  • Supports: align (full, wide), anchor, color (background, gradients, link, text), html
  • Attributes: align, focalPoint, href, imageFill, isStackedOnMobile, linkClass, linkDestination, linkTarget, mediaAlt, mediaId, mediaLink, mediaPosition, mediaSizeSlug, mediaType, mediaUrl, mediaWidth, rel, verticalAlignment

Top ↑

Unsupported Unsupported

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

  • Name: core/missing
  • Category: text
  • Supports: className, customClassName, html, inserter, reusable
  • Attributes: originalContent, originalName, originalUndelimitedContent

Top ↑

More More

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

  • Name: core/more
  • Category: design
  • Supports: className, customClassName, html, multiple
  • Attributes: customText, noTeaser

Top ↑

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

  • Name: core/navigation
  • Category: theme
  • Supports: align (full, wide), anchor, inserter, spacing (blockGap, units), typography (fontSize, lineHeight), html
  • Attributes: __unstableLocation, backgroundColor, customBackgroundColor, customOverlayBackgroundColor, customOverlayTextColor, customTextColor, openSubmenusOnClick, overlayBackgroundColor, overlayMenu, overlayTextColor, ref, rgbBackgroundColor, rgbTextColor, showSubmenuIcon, textColor

Top ↑

Define a navigation area for your theme. The navigation block associated with this area will be automatically displayed. (Source)

  • Name: core/navigation-area
  • Category: theme
  • Supports: html, inserter
  • Attributes: area

Top ↑

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

  • Name: core/navigation-link
  • Category: design
  • Supports: html, reusable
  • Attributes: description, id, isTopLevelLink, kind, label, opensInNewTab, rel, title, type, url

Top ↑

Add a submenu to your navigation. (Source)

  • Name: core/navigation-submenu
  • Category: design
  • Supports: html, reusable
  • Attributes: description, id, isTopLevelItem, kind, label, opensInNewTab, rel, title, type, url

Top ↑

Page Break Page Break

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

  • Name: core/nextpage
  • Category: design
  • Supports: className, customClassName, html
  • Attributes:

Top ↑

Page List Page List

Display a list of all pages. (Source)

  • Name: core/page-list
  • Category: widgets
  • Supports: html, reusable
  • Attributes: __unstableMaxPages

Top ↑

Paragraph Paragraph

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

  • Name: core/paragraph
  • Category: text
  • Supports: __unstablePasteTextInline, anchor, color (background, link, text), typography (fontSize, lineHeight), className
  • Attributes: align, content, direction, dropCap, placeholder

Top ↑

Pattern Pattern

Show a block pattern. (Source)

  • Name: core/pattern
  • Category: theme
  • Supports: html, inserter
  • Attributes: slug

Top ↑

Post Author Post Author

Display post author details such as name, avatar, and bio. (Source)

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

Top ↑

Post Author Name Post Author Name

The author name. (Source)

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

Top ↑

Post Comment (deprecated) Post Comment (deprecated)

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

  • Name: core/post-comment
  • Category: theme
  • Supports: html, inserter
  • Attributes: commentId

Top ↑

Post Comments Post Comments

Display a post’s comments. (Source)

  • Name: core/post-comments
  • Category: theme
  • Supports: align (full, wide), color (background, gradients, link, text), typography (fontSize, lineHeight), html
  • Attributes: textAlign

Top ↑

Post Comments Count Post Comments Count

Display a post’s comments count. (Source)

  • Name: core/post-comments-count
  • Category: theme
  • Supports: color (background, gradients, text), typography (fontSize, lineHeight), html
  • Attributes: textAlign

Top ↑

Post Comments Form Post Comments Form

Display a post’s comments form. (Source)

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

Top ↑

Post Comments Link Post Comments Link

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

  • Name: core/post-comments-link
  • Category: theme
  • Supports: color (background, link, text), typography (fontSize, lineHeight), html
  • Attributes: textAlign

Top ↑

Post Content Post Content

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

  • Name: core/post-content
  • Category: theme
  • Supports: align (full, wide), html
  • Attributes:

Top ↑

Post Date Post Date

Add the date of this post. (Source)

  • Name: core/post-date
  • Category: theme
  • Supports: color (background, gradients, link, text), typography (fontSize, lineHeight), html
  • Attributes: format, isLink, textAlign

Top ↑

Post Excerpt Post Excerpt

Display a post’s excerpt. (Source)

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

Top ↑

Post Featured Image Post Featured Image

Display a post’s featured image. (Source)

  • Name: core/post-featured-image
  • Category: theme
  • Supports: align (center, full, left, right, wide), color (background, text), spacing (margin, padding), html
  • Attributes: height, isLink, scale, width

Top ↑

Post Navigation Link Post Navigation Link

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

  • Name: core/post-navigation-link
  • Category: theme
  • Supports: typography (fontSize, lineHeight), html, reusable
  • Attributes: label, linkLabel, showTitle, textAlign, type

Top ↑

Post Template Post Template

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
  • Supports: align, html, reusable
  • Attributes:

Top ↑

Post Terms Post Terms

Post terms. (Source)

  • Name: core/post-terms
  • Category: theme
  • Supports: color (background, gradients, link, text), typography (fontSize, lineHeight), html
  • Attributes: separator, term, textAlign

Top ↑

Post Title Post Title

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

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

Top ↑

Preformatted Preformatted

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

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

Top ↑

Pullquote Pullquote

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

  • Name: core/pullquote
  • Category: text
  • Supports: align (full, left, right, wide), anchor, color (background, gradients, link, text), typography (fontSize, lineHeight)
  • Attributes: citation, textAlign, value

Top ↑

Query Loop Query Loop

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), color (background, gradients, link, text), html
  • Attributes: displayLayout, query, queryId, tagName

Top ↑

Pagination Pagination

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

  • Name: core/query-pagination
  • Category: theme
  • Supports: align, color (background, gradients, link, text), html, reusable
  • Attributes: paginationArrow

Top ↑

Next Page Next Page

Displays the next posts page link. (Source)

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

Top ↑

Page Numbers Page Numbers

Displays a list of page numbers for pagination (Source)

  • Name: core/query-pagination-numbers
  • Category: theme
  • Supports: html, reusable
  • Attributes:

Top ↑

Previous Page Previous Page

Displays the previous posts page link. (Source)

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

Top ↑

Query Title Query Title

Display the query title. (Source)

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

Top ↑

Quote Quote

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

  • Name: core/quote
  • Category: text
  • Supports: anchor, typography (fontSize, lineHeight)
  • Attributes: align, citation, value

Top ↑

RSS RSS

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

  • Name: core/rss
  • Category: widgets
  • Supports: align, html
  • Attributes: blockLayout, columns, displayAuthor, displayDate, displayExcerpt, excerptLength, feedURL, itemsToShow

Top ↑

Help visitors find your content. (Source)

  • Name: core/search
  • Category: widgets
  • Supports: align (center, left, right), color (background, gradients, text), html
  • Attributes: buttonPosition, buttonText, buttonUseIcon, label, placeholder, showLabel, width, widthUnit

Top ↑

Separator Separator

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

  • Name: core/separator
  • Category: design
  • Supports: align (center, full, wide), anchor
  • Attributes: color, customColor

Top ↑

Shortcode Shortcode

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

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

Top ↑

Display a graphic to represent this site. Update the block, and the changes apply everywhere it’s used. This is different than the site icon, which is the smaller image visible in your dashboard, browser tabs, etc used to help others recognize this site. (Source)

  • Name: core/site-logo
  • Category: theme
  • Supports: align, color (background, text), alignWide, html
  • Attributes: isLink, linkTarget, shouldSyncIcon, width

Top ↑

Site Tagline Site Tagline

Describe in a few words what the site is about. The tagline can be used in search results or when sharing on social networks even if it’s not displayed in the theme design. (Source)

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

Top ↑

Site Title Site Title

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), color (background, gradients, link, text), spacing (margin, padding), typography (fontSize, lineHeight), html
  • Attributes: isLink, level, linkTarget, textAlign

Top ↑

Social Icon Social Icon

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

  • Name: core/social-link
  • Category: widgets
  • Supports: html, reusable
  • Attributes: label, service, url

Top ↑

Social Icons Social Icons

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

  • Name: core/social-links
  • Category: widgets
  • Supports: align (center, left, right), anchor, spacing (blockGap, margin, units)
  • Attributes: customIconBackgroundColor, customIconColor, iconBackgroundColor, iconBackgroundColorValue, iconColor, iconColorValue, openInNewTab, size

Top ↑

Spacer Spacer

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

  • Name: core/spacer
  • Category: design
  • Supports: anchor
  • Attributes: height, width

Top ↑

Table Table

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

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

Top ↑

Table of Contents Table of Contents

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

  • Name: core/table-of-contents
  • Category: layout
  • Supports: html
  • Attributes: onlyIncludeCurrentPage

Top ↑

Tag Cloud Tag Cloud

A cloud of your most used tags. (Source)

  • Name: core/tag-cloud
  • Category: widgets
  • Supports: align, html
  • Attributes: numberOfTags, showTagCounts, taxonomy

Top ↑

Template Part Template Part

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, html, reusable
  • Attributes: area, slug, tagName, theme

Top ↑

Term Description Term Description

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

  • Name: core/term-description
  • Category: theme
  • Supports: align (full, wide), color (background, link, text), typography (fontSize, lineHeight), html
  • Attributes: textAlign

Top ↑

Text Columns (deprecated) Text Columns (deprecated)

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

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

Top ↑

Verse Verse

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

  • Name: core/verse
  • Category: text
  • Supports: anchor, color (background, gradients, link, text), spacing (padding), typography (fontSize, lineHeight)
  • Attributes: content, textAlign

Top ↑

Video Video

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

  • Name: core/video
  • Category: media
  • Supports: align, anchor
  • Attributes: autoplay, caption, controls, id, loop, muted, playsInline, poster, preload, src, tracks