filter_block_kses( WP_Block_Parser_Block $block, array[]|string $allowed_html, string[] $allowed_protocols = array() ): array

Filters and sanitizes a parsed block to remove non-allowable HTML from block attribute values.


$block WP_Block_Parser_Block Required
The parsed block object.
$allowed_html array[]|string Required
An array of allowed HTML elements and attributes, or a context name such as 'post'. See wp_kses_allowed_html() for the list of accepted context names.
$allowed_protocols string[] Optional
Array of allowed URL protocols.
Defaults to the result of wp_allowed_protocols() .

Default: array()

Top ↑


array The filtered and sanitized block object result.

Top ↑


File: wp-includes/blocks.php. View all references

function filter_block_kses( $block, $allowed_html, $allowed_protocols = array() ) {
	$block['attrs'] = filter_block_kses_value( $block['attrs'], $allowed_html, $allowed_protocols );

	if ( is_array( $block['innerBlocks'] ) ) {
		foreach ( $block['innerBlocks'] as $i => $inner_block ) {
			$block['innerBlocks'][ $i ] = filter_block_kses( $inner_block, $allowed_html, $allowed_protocols );

	return $block;

Top ↑


Version Description
5.3.1 Introduced.

Top ↑

User Contributed Notes

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