---
title: "lzb/sanitize_block_data"
description: "PHP filter `lzb/sanitize_block_data` of the Lazy Blocks WordPress plugin."
url: "https://www.lazyblocks.com/docs/php-filters/lzb-sanitize_block_data/"
source: "php-filters/lzb-sanitize_block_data.mdx"
---
# lzb/sanitize_block_data

Lists the block-level keys Lazy Blocks runs through `wp_kses_post()` before anything reads the block list.

A block field you add through [lzb/block_data](https://www.lazyblocks.com/docs/php-filters/lzb-block_data/) is stored and printed as it was typed. Add its key here and it gets the same escaping the built-in fields get.

## Attributes

| Name                   | Type      | Description                                                                                |
| ---------------------- | --------- | ------------------------------------------------------------------------------------------ |
| `$sanitize_block_data` | **Array** | block keys to sanitize, `title`, `description`, `category` and `category_label` by default |

The list is a flat array of top-level block keys. `sanitize_block_configs()` walks every block and replaces `$block[ $key ]` with `wp_kses_post( $block[ $key ] )` for each key in the list, skipping the ones that are empty. Control-level keys are handled by the separate [lzb/sanitize_block_control_data](https://www.lazyblocks.com/docs/php-filters/lzb-sanitize_block_control_data/) list.

## Usage

```php title="PHP"
function my_lzb_sanitize_block_data( $names ) {
  // A field added to every block through lzb/block_data, printed in the
  // inspector as markup, so it needs the same escaping the label gets.
  $names[] = 'documentation_note';

  return $names;
}

add_filter( 'lzb/sanitize_block_data', 'my_lzb_sanitize_block_data' );
```

`sanitize_block_configs()` is attached to [lzb/get_blocks](https://www.lazyblocks.com/docs/php-filters/lzb-get_blocks/) at priority 100, so it runs after every other handler on that filter and there is no way to add a key back afterwards. Removing a key from the list turns the escaping off for that field on every block. Returning anything but an array raises a `TypeError` at the `foreach` that follows.

## Documentation Index
> Fetch the complete documentation index at: https://www.lazyblocks.com/llms.txt
> Fetch every page in a single file at: https://www.lazyblocks.com/llms-full.txt