Full site editing blocks

Below is a quick reference or cheat sheet for the blocks that are available with full site editing.

You can download this as a pdf.

Full site editing blocks -Reference

Updated 2020-06-04, Gutenberg version 8.2 or later. All of these blocks requires full site editing to be enabled.

Post blocks: https://github.com/WordPress/gutenberg/issues/15623

Please see this issue for planned changes: https://github.com/WordPress/gutenberg/issues/21087

Post blocks:

Post title

<!-- wp:post-title /-->

Output:

<h1>Hello world!</h1>

Issues and pull requests:

https://github.com/WordPress/gutenberg/labels/%5BBlock%5D%20Post%20Title

Post author

The Post author block lets you change the post author, and presents the author information.

There are options to display a byline, gravatar, and author description. The description cannot be edited.

<!-- wp:post-author /-->

Output:

<div class="wp-block-post-author">
<div class="wp-block-post-author__content">
<p class="wp-block-post-author__name">author name</p>
</div></div>

Issues and pull requests

https://github.com/WordPress/gutenberg/issues?q=is%3Aclosed+label%3A%22%5BBlock%5D+Post+Author%22

https://github.com/WordPress/gutenberg/issues/19696

Post date

The post date blocks lets you schedule posts, and select the date format for the output of the date.

<!-- wp:post-date /-->

Output:

<time datetime="2020-05-28T10:29:20+00:00">May 28, 2020</time>

Issues and pull requests

https://github.com/WordPress/gutenberg/issues/19697

Post excerpt

The Post excerpt block includes options to add a read more link below the excerpt and change the link text.

You can choose whether to display the link on the same line as the content, or below it. You can also choose the length of the excerpt.

<!-- wp:post-excerpt /-->

Output:

<p>excerpt</p>

Optional Read More link to the post:

<p><a href=”(post link)”>Link text</a></p>

Issues and pull requests

https://github.com/WordPress/gutenberg/issues/19698

Post tags

In its first basic version, the block displays the post tags. In the ticket listed below you can read about the planned features.

<!-- wp:post-tags /-->

Output:

<a href="http://example.com/?tag=sample">sample</a> | <a href="http://example.com/?tag=test">test</a></div>

Issues and pull requests

https://github.com/WordPress/gutenberg/pull/20418

https://github.com/WordPress/gutenberg/pull/19580

Post featured image

<!-- wp:post-featured-image /-->

Output

(Example sizes. Note that the wrapping p tag is part of the default output.)

<p><img width="320" height="213" src="(path to image)" class="attachment-post-thumbnail size-post-thumbnail wp-post-image" alt="" srcset="(path to image) 320w, (path to image) 300w" sizes="(max-width: 320px) 100vw, 320px" /></p>

Issues and pull requests

https://github.com/WordPress/gutenberg/labels/%5BBlock%5D%20Post%20Featured%20Image

Post content

<!-- wp:post-content /-->

Output:

<div class="entry-content">
<p>Welcome to WordPress. This is your first post. Edit or delete it, then start writing!</p>
</div>

Issues and pull requests

https://github.com/WordPress/gutenberg/issues/22080

https://github.com/WordPress/gutenberg/pull/22473

https://github.com/WordPress/gutenberg/pull/18461

Comment blocks:

Post comments count

<!-- wp:post-comments-count /-->

Output:

<span class="wp-block-post-comments-count">1</span>

Post comments

Uses the comments_template() on the front, refer to https://developer.wordpress.org/reference/functions/comments_template/

There are plans to create separate blocks for these different element, like the comment area heading, comment navigation, etc.

<!-- wp:post-comments /-->

Issues and pull requests

https://github.com/WordPress/gutenberg/labels/%5BBlock%5D%20Post%20Comments

Post comments form

Uses comment_form() on the front, refer to https://developer.wordpress.org/reference/functions/comment_form/

<!-- wp:post-comments-form /-->

Other blocks:

Site Title

<!-- wp:site-title /-->

Output:

<h1>Theme Preview</h1>

Issues and pull requests

https://github.com/WordPress/gutenberg/issues/19491

https://github.com/WordPress/gutenberg/pull/17207

Query, Loop, and query pagination

<!-- wp:query {"queryId":0} -->
<!-- wp:query-loop --><!-- /wp:query-loop -->
<!-- wp:query-pagination /-->
<!-- /wp:query /-->

Example with content inside the loop:

<!-- wp:query {"queryId":0,"query":{"per_page":4,"pages":5,"offset":0}} -->
<!-- wp:query-loop /-->
<!-- wp:post-title /-->
<!-- wp:post-content /-->
<!-- /wp:query-loop -->

<!-- wp:query-pagination /-->
<!-- /wp:query /-->

Issues and pull requests

https://github.com/WordPress/gutenberg/pull/22199

Blocks that are under development:

Site description

https://github.com/WordPress/gutenberg/pull/18241

Category / Hierarchical taxonomy

https://github.com/WordPress/gutenberg/pull/22471