For features included in the Gutenberg plugin, the deprecation policy is intended to support backward compatibility for two minor plugin releases, when possible. Features and code included in a stable release of WordPress are not included in this deprecation timeline, and are instead subject to the versioning policies of the WordPress project. The current deprecations are listed below and are grouped by the version at which they will be removed completely. If your plugin depends on these behaviors, you must update to the recommended alternative before the noted version.
Unreleased
wp.blocks.isValidBlockContenthas been removed. Please usewp.blocks.validateBlockinstead.
11.0.0
wp.blocks.registerBlockTypeFromMetadatamethod has been removed. Usewp.blocks.registerBlockTypemethod instead.
10.3.0
- Passing a tuple of components with
asprop toActionItem.Slotcomponent is no longer supported. Please pass a component withasprop instead. Example:
“`diff
<ActionItem.Slot
name=”my/slot”
label={ __( ‘My slot’ ) }- as={ [ MenuGroup, MenuItem ] }
- as={ MenuGroup }
/>
“`
9.7.0
leftSidebarprop inInterfaceSkeletoncomponent has been removed. UsesecondarySidebarprop instead.
8.6.0
- Block API integration with Block Context was updated. When registering a block use
usesContextandprovidesContextpair in JavaScript files anduses_contextandprovides_contextpair in PHP files instead of previous paircontextandprovidesContext.
8.3.0
- The PHP function
gutenberg_get_post_from_contexthas been removed. Use Block Context instead. - The old Block Pattern APIs
register_pattern/unregister_patternhave been removed. Use the new functions instead.
5.5.0
- The PHP function
gutenberg_inithas been removed. - The PHP function
is_gutenberg_pagehas been removed. UseWP_Screen::is_block_editorinstead. - The PHP function
the_gutenberg_projecthas been removed. - The PHP function
gutenberg_default_post_format_templatehas been removed. - The PHP function
gutenberg_get_available_image_sizeshas been removed. - The PHP function
gutenberg_get_autosave_newer_than_post_savehas been removed. - The PHP function
gutenberg_editor_scripts_and_styleshas been removed.
5.4.0
- The PHP function
gutenberg_load_plugin_textdomainhas been removed. - The PHP function
gutenberg_get_jed_locale_datahas been removed. - The PHP function
gutenberg_load_locale_datahas been removed.
5.3.0
- The PHP function
gutenberg_redirect_to_classic_editor_when_saving_postshas been removed. - The PHP function
gutenberg_revisions_link_to_editorhas been removed. - The PHP function
gutenberg_remember_classic_editor_when_saving_postshas been removed. - The PHP function
gutenberg_can_edit_post_typehas been removed. Useuse_block_editor_for_post_typeinstead. - The PHP function
gutenberg_can_edit_posthas been removed. Useuse_block_editor_for_postinstead.
5.2.0
- The PHP function
gutenberg_parse_blockshas been removed. Useparse_blocksinstead. - The PHP function
get_dynamic_blocks_regexhas been removed. - The PHP function
gutenberg_render_blockhas been removed. Userender_blockinstead. - The PHP function
strip_dynamic_blockshas been removed. For use in excerpt preparation, considerexcerpt_remove_blocksinstead. - The PHP function
strip_dynamic_blocks_add_filterhas been removed. - The PHP function
strip_dynamic_blocks_remove_filterhas been removed. - The PHP function
gutenberg_post_has_blockshas been removed. Usehas_blocksinstead. - The PHP function
gutenberg_content_has_blockshas been removed. Usehas_blocksinstead. - The PHP function
gutenberg_register_rest_routeshas been removed. - The PHP function
gutenberg_add_taxonomy_visibility_fieldhas been removed. - The PHP function
gutenberg_get_taxonomy_visibility_datahas been removed. - The PHP function
gutenberg_add_permalink_template_to_postshas been removed. - The PHP function
gutenberg_add_block_format_to_post_contenthas been removed. - The PHP function
gutenberg_add_target_schema_to_linkshas been removed. - The PHP function
gutenberg_register_post_prepare_functionshas been removed. - The PHP function
gutenberg_silence_rest_errorshas been removed. - The PHP function
gutenberg_filter_post_type_labelshas been removed. - The PHP function
gutenberg_preload_api_requesthas been removed. Userest_preload_api_requestinstead. - The PHP function
gutenberg_remove_wpcom_markdown_supporthas been removed. - The PHP function
gutenberg_add_gutenberg_post_statehas been removed. - The PHP function
gutenberg_bulk_post_updated_messageshas been removed. - The PHP function
gutenberg_kses_allowedtagshas been removed. - The PHP function
gutenberg_add_responsive_body_classhas been removed. - The PHP function
gutenberg_add_edit_link_filtershas been removed. - The PHP function
gutenberg_add_edit_linkhas been removed. - The PHP function
gutenberg_block_bulk_actionshas been removed. - The PHP function
gutenberg_replace_default_add_new_buttonhas been removed. - The PHP function
gutenberg_content_block_versionhas been removed. Useblock_versioninstead. - The PHP function
gutenberg_get_block_categorieshas been removed. Useget_block_categoriesinstead. - The PHP function
register_tinymce_scriptshas been removed. Usewp_register_tinymce_scriptsinstead. - The PHP function
gutenberg_register_post_typeshas been removed. - The
gutenbergtheme support option has been removed. Usealign-wideinstead. - The PHP function
gutenberg_prepare_blocks_for_jshas been removed. Useget_block_editor_server_block_settingsinstead. - The PHP function
gutenberg_load_list_reusable_blockshas been removed. - The PHP function
_gutenberg_utf8_splithas been removed. Use_mb_substrinstead. - The PHP function
gutenberg_disable_editor_settings_wpautophas been removed. - The PHP function
gutenberg_add_rest_nonce_to_heartbeat_response_headershas been removed. - The PHP function
gutenberg_check_if_classic_needs_warning_about_blockshas been removed. - The PHP function
gutenberg_warn_classic_about_blockshas been removed. - The PHP function
gutenberg_show_privacy_policy_help_texthas been removed. - The PHP function
gutenberg_common_scripts_and_styleshas been removed. Usewp_common_block_scripts_and_stylesinstead. - The PHP function
gutenberg_enqueue_registered_block_scripts_and_styleshas been removed. Usewp_enqueue_registered_block_scripts_and_stylesinstead. - The PHP function
gutenberg_meta_box_savehas been removed. - The PHP function
gutenberg_meta_box_save_redirecthas been removed. - The PHP function
gutenberg_filter_meta_boxeshas been removed. - The PHP function
gutenberg_intercept_meta_box_renderhas been removed. - The PHP function
gutenberg_override_meta_box_callbackhas been removed. - The PHP function
gutenberg_show_meta_box_warninghas been removed. - The PHP function
the_gutenberg_metaboxeshas been removed. Usethe_block_editor_meta_boxesinstead. - The PHP function
gutenberg_meta_box_post_form_hidden_fieldshas been removed. Usethe_block_editor_meta_box_post_form_hidden_fieldsinstead. - The PHP function
gutenberg_toggle_custom_fieldshas been removed. - The PHP function
gutenberg_collect_meta_box_datahas been removed. Useregister_and_do_post_meta_boxesinstead. window._wpLoadGutenbergEditorhas been removed. Usewindow._wpLoadBlockEditorinstead. Note: This is a private API, not intended for public use. It may be removed in the future.- The PHP function
gutenberg_get_script_polyfillhas been removed. Usewp_get_script_polyfillinstead. - The PHP function
gutenberg_add_admin_body_classhas been removed. Use the.block-editor-pageclass selector in your stylesheets if you need to scope styles to the block editor screen.
4.5.0
Dropdown.refresh()has been deprecated as the containedPopoveris now automatically refreshed.wp.editor.PostPublishPanelTogglehas been deprecated in favor ofwp.editor.PostPublishButton.
4.4.0
wp.date.getSettingshas been removed. Please usewp.date.__experimentalGetSettingsinstead.wp.compose.remountOnPropChangehas been removed.- The following editor store actions have been removed:
createNotice,removeNotice,createSuccessNotice,createInfoNotice,createErrorNotice,createWarningNotice. Use the equivalent actions by the same name from the@wordpress/noticesmodule. - The id prop of wp.nux.DotTip has been removed. Please use the tipId prop instead.
wp.blocks.isValidBlockhas been removed. Please usewp.blocks.isValidBlockContentinstead but keep in mind that the order of params has changed.wp.dataregistry.registerReducerhas been deprecated. Useregistry.registerStoreinstead.wp.data