WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

unregister_block_style()

unregister_block_style( string $block_name, string $block_style_name ): bool

In this article

Back to top

Unregisters a block style.

Parameters

$block_namestringrequired
Block type name including namespace.
$block_style_namestringrequired
Block style name.

Return

bool True if the block style was unregistered with success and false otherwise.

Source

wp-includes/blocks.php
Copy
function unregister_block_style( $block_name, $block_style_name ) {
	return WP_Block_Styles_Registry::get_instance()->unregister( $block_name, $block_style_name );
}

View all references View on Trac View on GitHub

UsesDescription
WP_Block_Styles_Registry::get_instance()wp-includes/class-wp-block-styles-registry.php

Utility method to retrieve the main instance of the class.

Changelog

VersionDescription
5.3.0Introduced.

User Contributed Notes

  1. Skip to note 3 content
    Marie Comet
    You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

    The following code sample unregister the style named ‘fancy-quote’ from the core quote block:

    unregister_block_style( 'core/quote', 'fancy-quote' );

    Important: The function unregister_block_style only unregisters styles that were registered on the server using register_block_style. The function does not unregister a style registered using client-side code.

  2. Skip to note 4 content
    Jason Raveling
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    As Marie Comet mentioned, you cannot use unregister_block_style() on a style that was registered serverside (e.g. via PHP). The following PHP will not unregister a block style from the core/table block:

    wp-includes/blocks.php
    Copy
    // PHP
unregister_block_style( 'core/table', 'stripes' );

    You can use the Block API via JavaScript to unregister it. Running the following JavaScript will successfully unregister the style.

    wp-includes/blocks.php
    Copy
    // JavaScript
wp.blocks.unregisterBlockStyle( 'core/table', 'stripes' );

    For more info, look under Styles in the Block API Reference of the Block Editor Handbook.

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