@wordpress/blocks

## Unreleased ## 15.9.0 (2025-11-26) ## 15.8.0 (2025-11-12) ## 15.7.0 (2025-10-29) ## 15.6.0 (2025-10-17) ## 15.5.0 (2025-10-01) ## 15.4.0 (2025-09-17) ## 15.3.0 (2025-09-03) ## 15.2.0 (2025-08-20) ## 15.1.0 (2025-08-07) ## 15.0.0 (2025-07-23) ### Breaking changes - `registerBlockType`: Set default `apiVersion` when none is provided during client-side block registration ([#70750](https://github.com/WordPress/gutenberg/pull/70750)). ## 14.15.0 (2025-06-25) ## 14.14.0 (2025-06-04) ## 14.13.0 (2025-05-22) ## 14.12.0 (2025-05-07) ## 14.11.0 (2025-04-11) ## 14.10.0 (2025-03-27) ## 14.9.0 (2025-03-13) ## 14.8.0 (2025-02-28) ## 14.7.0 (2025-02-12) ## 14.6.0 (2025-01-29) ## 14.5.0 (2025-01-15) ## 14.4.0 (2025-01-02) ## 14.3.0 (2024-12-11) ## 14.2.0 (2024-11-27) ## 14.1.0 (2024-11-16) ## 14.0.0 (2024-10-30) ### Breaking changes - Normalize `blockType.parent` to be an array. While string values were never supported, they appeared to work with some unintended side-effects that have been fixed by [#66250](https://github.com/WordPress/gutenberg/pull/66250). For that reason, we've added some code that automatically migrates strings to arrays — though it still raises a warning. ## 13.10.0 (2024-10-16) ## 13.9.0 (2024-10-03) ## 13.8.0 (2024-09-19) ## 13.7.0 (2024-09-05) ## 13.6.0 (2024-08-21) ## 13.5.0 (2024-08-07) ## 13.4.0 (2024-07-24) ## 13.3.0 (2024-07-10) ## 13.2.0 (2024-06-26) ## 13.1.0 (2024-06-15) ## 13.0.0 (2024-05-31) ### Breaking Changes - Variables like `process.env.IS_GUTENBERG_PLUGIN` have been replaced by `globalThis.IS_GUTENBERG_PLUGIN`. Build systems using `process.env` should be updated ([#61486](https://github.com/WordPress/gutenberg/pull/61486)). - Increase the minimum required Node.js version to v18.12.0 matching long-term support releases ([#31270](https://github.com/WordPress/gutenberg/pull/61930)). Learn more about [Node.js releases](https://nodejs.org/en/about/previous-releases). ## 12.35.0 (2024-05-16) ## 12.34.0 (2024-05-02) ## 12.33.0 (2024-04-19) ## 12.32.0 (2024-04-03) ## 12.31.0 (2024-03-21) ## 12.30.0 (2024-03-06) ## 12.29.0 (2024-02-21) ## 12.28.0 (2024-02-09) ## 12.27.0 (2024-01-24) ## 12.26.0 (2024-01-10) ## 12.25.0 (2023-12-13) ## 12.24.0 (2023-11-29) ## 12.23.0 (2023-11-16) ## 12.22.0 (2023-11-02) ## 12.21.0 (2023-10-18) ## 12.20.0 (2023-10-05) ## 12.19.0 (2023-09-20) ## 12.18.0 (2023-08-31) ## 12.17.0 (2023-08-16) ## 12.16.0 (2023-08-10) ## 12.15.0 (2023-07-20) ## 12.14.0 (2023-07-05) ## 12.13.0 (2023-06-23) ## 12.12.0 (2023-06-07) ## 12.11.0 (2023-05-24) ## 12.10.0 (2023-05-10) ## 12.9.0 (2023-04-26) ## 12.8.0 (2023-04-12) ## 12.7.0 (2023-03-29) ## 12.6.0 (2023-03-15) ## 12.5.0 (2023-03-01) ## 12.4.0 (2023-02-15) ## 12.3.0 (2023-02-01) ## 12.2.0 (2023-01-11) ## 12.1.0 (2023-01-02) ## 12.0.0 (2022-12-14) ### Breaking Changes - Updated dependencies to require React 18 ([45235](https://github.com/WordPress/gutenberg/pull/45235)) ## 11.21.0 (2022-11-16) ## 11.20.0 (2022-11-02) ## 11.19.0 (2022-10-19) ## 11.18.0 (2022-10-05) ### Deprecations - Deprecate non-string descriptions ([#44455](https://github.com/WordPress/gutenberg/pull/44455)). ## 11.17.0 (2022-09-21) - The block attribute sources `children` and `node` have been deprecated. Please use the `html` source instead. See https://developer.wordpress.org/block-editor/how-to-guides/block-tutorial/introducing-attributes-and-editable-fields/ and the core blocks for examples. ## 11.16.0 (2022-09-13) ## 11.15.0 (2022-08-24) ### Bug Fixes - Packages: Replace `is-plain-obj` with `is-plain-object` ([#43511](https://github.com/WordPress/gutenberg/pull/43511)). ## 11.14.0 (2022-08-10) ## 11.13.0 (2022-07-27) ## 11.12.0 (2022-07-13) ### Deprecations - `withBlockContentContext` is no longer used by the block editor and therefore got deprecated ([#41395](https://github.com/WordPress/gutenberg/pull/41395)). ### New Features - The shortcode transformer now accepts a `transform` method to allow advanced controls over the transformed result. For instance, it's now possible to define custom `innerBlocks` for the transformed block. ([#42001](https://github.com/WordPress/gutenberg/pull/42001)) ## 11.11.0 (2022-06-29) ## 11.10.0 (2022-06-15) ## 11.9.0 (2022-06-01) ## 11.8.0 (2022-05-18) ## 11.7.0 (2022-05-04) ## 11.6.0 (2022-04-21) ## 11.5.0 (2022-04-08) ## 11.4.0 (2022-03-23) ## 11.3.0 (2022-03-11) ## 11.2.0 (2022-01-27) ## 11.1.0 (2021-09-09) ### Bug Fixes - Register a block even when an invalid value provided for the icon setting ([#34350](https://github.com/WordPress/gutenberg/pull/34350)). ### New Features - The `isMatch` callback on block transforms now receives the block object (or block objects if `isMulti` is `true`) as its second argument. ## 11.0.0 (2021-07-29) ### Breaking Changes - Upgraded React components to work with v17.0 ([#29118](https://github.com/WordPress/gutenberg/pull/29118)). There are no new features in React v17.0 as explained in the [blog post](https://reactjs.org/blog/2020/10/20/react-v17.html). ## 10.0.0 (2021-07-21) ### Breaking Changes - The deprecated `registerBlockTypeFromMetadata` function was removed. Please use `registerBlockType` that covers the same functionality ([#32030](https://github.com/WordPress/gutenberg/pull/32030)). ## 9.1.0 (2021-05-20) ### New Features - `registerBlockType` method can be used to register a block type using the metadata loaded from `block.json` file ([#32030](https://github.com/WordPress/gutenberg/pull/32030)). ### Deprecations - `registerBlockTypeFromMetadata` was deprecated in favor of `registerBlockType` that support now the same functionality ([#32030](https://github.com/WordPress/gutenberg/pull/32030)). ## 9.0.0 (2021-05-14) ### Breaking Changes - Drop support for Internet Explorer 11 ([#31110](https://github.com/WordPress/gutenberg/pull/31110)). Learn more at https://make.wordpress.org/core/2021/04/22/ie-11-support-phase-out-plan/. - Increase the minimum Node.js version to v12 matching Long Term Support releases ([#31270](https://github.com/WordPress/gutenberg/pull/31270)). Learn more at https://nodejs.org/en/about/releases/. ### New Features - `registerBlockTypeFromMetadata` method can be used to register a block type using the metadata loaded from `block.json` file ([#30293](https://github.com/WordPress/gutenberg/pull/30293)). ## 8.0.0 (2021-03-17) ### Breaking Changes - Reverted `cloneBlock` back to its original logic that doesn't sanitize block's attributes. [#28379](https://github.com/WordPress/gutenberg/pull/29111) ## 7.0.0 (2021-02-01) ### Breaking Changes - `cloneBlock` now sanitizes the attributes to match the same logic `createBlock` has. [#28379](https://github.com/WordPress/gutenberg/pull/28379) ## 6.25.0 (2020-12-17) ### New Features - Added a store definition `store` for the blocks namespace to use with `@wordpress/data` API ([#26655](https://github.com/WordPress/gutenberg/pull/26655)). ## 6.13.0 (2020-04-01) ### New Features - Blocks can now be registered with an `defaultStylePicker` flag in the `supports` setting, allowing the default style picker to be removed. ## 6.4.0 (2019-08-05) ### Enhancements - Omitting `attributes` or `keywords` settings will now stub default values (an empty object or empty array, respectively). ### Bug Fixes - The `'blocks.registerBlockType'` filter is now applied to each of a block's deprecated settings as well as the block's main settings. Ensures `supports` settings like `anchor` work for deprecations. ## 6.3.0 (2019-05-21) ### New Features - Added a default implementation for `save` setting in `registerBlockType` which saves no markup in the post content. - Added wildcard block transforms which allows for transforming all/any blocks in another block. ## 6.1.0 (2019-03-06) ### New Features - Blocks' `transforms` will receive `innerBlocks` as the second argument (or an array of each block's respective `innerBlocks` for a multi-transform). ### Bug Fixes - Block validation will now correctly validate character references, resolving some issues where a standalone ampersand `&` followed later in markup by a character reference (e.g. `&`) could wrongly mark a block as being invalid. ([#13512](https://github.com/WordPress/gutenberg/pull/13512)) ## 6.0.5 (2019-01-03) ## 6.0.4 (2018-12-12) ## 6.0.3 (2018-11-30) ## 6.0.2 (2018-11-21) ## 6.0.1 (2018-11-20) ## 6.0.0 (2018-11-15) ### Breaking Changes - `isValidBlock` has been removed. Please use `isValidBlockContent` instead but keep in mind that the order of params has changed. ### Bug Fixes - The block validator is more lenient toward equivalent encoding forms. ## 5.3.1 (2018-11-12) ## 5.3.0 (2018-11-09) ### New Features - `getBlockAttributes`, `getBlockTransforms`, `getSaveContent`, `getSaveElement` and `isValidBlockContent` methods can now take also block's name as the first param ([#11490](https://github.com/WordPress/gutenberg/pull/11490)). Passing a block's type object continues to work as before. - `registerBlockStyles` and `unregisterBlockStyles` can be triggered at any moment (before or after block registration). ## 5.2.0 (2018-11-09) - Paste: Google Docs: fix nested formatting, sub, sup and del. - Expose @wordpress/editor to Gutenberg mobile. - Separate Paste Handler. ## 5.1.2 (2018-11-03) ## 5.1.1 (2018-10-30) ## 5.1.0 (2018-10-30) ### New Features - `isValidBlockContent` function has been added ([#10891](https://github.com/WordPress/gutenberg/pull/10891)). ### Deprecations - `isValidBlock` function has been deprecated ([#10891](https://github.com/WordPress/gutenberg/pull/10891)). Use `isValidBlockContent` instead. ## 5.0.0 (2018-10-29) ### Breaking Changes - Attribute type coercion has been removed. Omit the source to preserve type via serialized comment demarcation. - `setUnknownTypeHandlerName` has been removed. Please use `setFreeformContentHandlerName` and `setUnregisteredTypeHandlerName` instead. - `getUnknownTypeHandlerName` has been removed. Please use `getFreeformContentHandlerName` and `getUnregisteredTypeHandlerName` instead. ### New Features - Added a `unregisterBlockStyle()` function to remove a block style variation. ## 4.0.4 (2018-10-19) ## 4.0.3 (2018-10-18) ## 4.0.0 (2018-09-30) ### Breaking Changes - `getDefaultBlockForPostFormat` has been removed. ## 3.0.0 (2018-09-05) ### Breaking Changes - The `isSharedBlock` function is removed. Use `isReusableBlock` instead. - Change how required built-ins are polyfilled with Babel 7 ([#9171](https://github.com/WordPress/gutenberg/pull/9171)). If you're using an environment that has limited or no support for ES2015+ such as lower versions of IE then using [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](https://babeljs.io/docs/en/next/babel-polyfill) will add support for these methods. ### Deprecations - The `getDefaultBlockForPostFormat` function has been deprecated.