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

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

Parameters Parameters


(WP_Block_Parser_Block) (Required) The parsed block object.


(array[]|string) (Required) An array of allowed HTML elements and attributes, or a context name such as 'post'.


(string[]) (Optional) Allowed URL protocols.

Default value: array()

Top ↑

Return Return

(array) The filtered and sanitized block object result.

Top ↑

Source Source

File: wp-includes/blocks.php

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 ↑

Changelog Changelog

Version Description
5.3.1 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

Top ↑

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