Issue with Registering a Pattern Category – Slug Conversion Creates Duplicate Categories

[jigneshnakrani088]

Issue Description

The example provided in the Registering a Pattern Category documentation is incorrect because WordPress does not support / in slugs. Instead, it automatically converts / to -, leading to unintended duplicate categories.

URL of the Page with the Issue

https://developer.wordpress.org/themes/patterns/registering-patterns/#registering-a-pattern-category

Section of Page with the issue

Registering a Pattern Category

Why is this a problem?

Suggested Fix

Try adding a new custom pattern category for your theme. Add this code to your theme’s functions.php file:

add_action( 'init', 'themeslug_register_pattern_categories' );

function themeslug_register_pattern_categories() {
	register_block_pattern_category( 'themeslug-custom', array( 
		'label'       => __( 'Theme Name: Custom', 'themeslug' ),
		'description' => __( 'Custom patterns for Theme Name.', 'themeslug' )
	) );
}

Now try adding the themeslug-custom category to any block pattern:

<?php
/**
 * Title: Hero
 * Slug: themeslug/hero
 * Categories: featured, themeslug-custom
 */
?>
<!-- Your block markup goes here. -->

[github-actions]

Heads up @WordPress/docs-issues-coordinators, we have a new issue open. Time to use 'em labels.