wp_create_category( string $category_name, int $category_parent = 0 ): int

Parameters

$category_namestring

Category name.

$category_parentintoptional

ID of parent category.Default: 0

Return

int

The ID of category term on success, or zero on failure.

Uses · 2

• category_exists()Checks whether a category exists.
• wp_insert_category()Updates an existing Category or creates a new Category.

Used by · 1

• wp_create_categories()Creates categories for the given post.

Source

View on Trac ↗View on GitHub ↗

55function wp_create_category( $category_name, $category_parent = 0 ) {56	$id = category_exists( $category_name, $category_parent );57	if ( $id ) {58		return (int) $id;59	}60 61	return wp_insert_category(62		array(63			'cat_name'        => $category_name,64			'category_parent' => $category_parent,65		)66	);67}

History

Introduced in 2.0.0. 3 changes between 6.7.7 and 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-admin/includes/taxonomy.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.