register_block_pattern_category( string $category_name, array $category_properties )

Registers a new pattern category.


Parameters

$category_name

(string) (Required) Pattern category name including namespace.

$category_properties

(array) (Required) List of properties for the block pattern. See WP_Block_Pattern_Categories_Registry::register() for accepted arguments.


Top ↑

Return

(bool) True if the pattern category was registered with success and false otherwise.


Top ↑

Source

File: wp-includes/class-wp-block-pattern-categories-registry.php

function register_block_pattern_category( $category_name, $category_properties ) {
	return WP_Block_Pattern_Categories_Registry::get_instance()->register( $category_name, $category_properties );
}


Top ↑

Changelog

Changelog
Version Description
5.5.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    Contributed by Christina Blust

    Example from Block Editor Handbook:

    register_block_pattern_category(
        'hero',
        array( 'label' => __( 'Hero', 'wpdocs-my-plugin' ) )
    );

    These categories already exist in core as of 5.5.1:

    • buttons
    • columns
    • gallery
    • header
    • text

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