has_blocks( int|string|WP_Post|null $post = null )

Determine whether a post or content string has blocks.

Description Description

This test optimizes for performance rather than strict accuracy, detecting the pattern of a block but not validating its structure. For strict accuracy, you should use the block parser on post content.

See also See also

Top ↑

Parameters Parameters


(int|string|WP_Post|null) (Optional) Post content, post ID, or post object. Defaults to global $post.

Default value: null

Top ↑

Return Return

(bool) Whether the post has blocks.

Top ↑

Source Source

File: wp-includes/blocks.php

function has_blocks( $post = null ) {
	if ( ! is_string( $post ) ) {
		$wp_post = get_post( $post );
		if ( $wp_post instanceof WP_Post ) {
			$post = $wp_post->post_content;

	return false !== strpos( (string) $post, '<!-- wp:' );

Top ↑

Changelog Changelog

Version Description
5.0.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.