W3cubDocs

/WordPress

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

Determines whether a post or content string has blocks.

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

Parameters

$postint|string|WP_Post|nulloptional
Post content, post ID, or post object.
Defaults to global $post.

Default:null

Return

bool Whether the post has blocks.

Source

function has_blocks( $post = null ) {
	if ( ! is_string( $post ) ) {
		$wp_post = get_post( $post );

		if ( ! $wp_post instanceof WP_Post ) {
			return false;
		}

		$post = $wp_post->post_content;
	}

	return str_contains( (string) $post, '<!-- wp:' );
}

Changelog

Version Description
5.0.0 Introduced.

© 2003–2024 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/has_blocks