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

User Contributed Notes

1. Skip to note 4 content

   Marie Comet 5 years ago

   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 5 content

   Jason Raveling 2 years ago

   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:

   // 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.

   // JavaScript
   wp.blocks.unregisterBlockStyle( 'core/table', 'stripes' );

   For more info, look under Styles in the Block API Reference of the Block Editor Handbook.
3. Skip to note 6 content

   Max Bond 1 year ago

   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

   I wanted to unregister default core/quote block Plain style.

   First I have tried unregister_block_style(‘core/quote’, ‘plain’) – not working!

   Then I tried JS wp.blocks.unregisterBlockStyle() – partly working! Block style was removed from editor, but was present in FSE Style guide section!…

   Then I came back to PHP and tried to filter block.json args:

   add_filter( 'register_block_type_args', function ( $args, $block_type ) {
   	if ( 'core/quote' === $block_type ) {
   		unset($args['styles']);
   	}
   
   	return $args;
   }, 10, 2 );

   … And it worked finally! This API seems inconsistent… (