Block Category Registration

How to register custom Gutenberg Block Category

June 4, 2024 ultraDevs 2 Comments

You might be familiar with Gutenberg, the new block-grounded editor introduced in WordPress 5, If you are a WordPress developer Gutenberg allows you to create custom blocks, which are basically applicable pieces of content that you can use to build pages and posts.

By default, Gutenberg comes with some built-in block categories, such as Text, Media, Design, Widgets, etc. However, if you want to create custom blocks for your clients or someone you can create your own custom Gutenberg block category.

Register Gutenberg Block Category

Here’s how we can do it, and still maintain the backward compatibility for WordPress lower than 5.8.

// Create Block Category.
function mh_custom_block_category( $categories ) {
	return array_merge(
	  $categories,
		array(
			array(
				'slug'  => 'custom-blocks',
				'title' => __( 'Custom Blocks', 'textdomain' ),
			),
		)
	);
}
global $wp_version;
add_filter( 'block_categories' . ( version_compare( $wp_version, '5.8', '>=' ) ? '_all' : '' ), 'mh_custom_block_category', 99 );
PHP

Change your custom block category to custom-blocks

{
  "name": "custom-blocks/tabs",
  "version": "0.1.0",
  "title": "Custom Blocks",
  "category": "custom-blocks",
  "icon": "smiley",
  "description": "Custom Blocks"
}
JSON

save and you will see your custom category.

Gutenberg Block Category

Thanks for reading! I hope this post will help you. If you have any questions related to this post please feel free to leave them below.

WordPress Doc

Hire US

if you are looking for a developer to help with your project don’t hesitate to contact us.

Thanks again!

2 responses to “How to register custom Gutenberg Block Category”

Leave a Reply

Your email address will not be published. Required fields are marked *