wp_create_category( int|string $cat_name, int $parent )

Add a new category to the database if it does not already exist.


Description Description


Parameters Parameters

$cat_name

(int|string) (Required)

$parent

(int) (Required)


Top ↑

Return Return

(int|WP_Error)


Top ↑

Source Source

File: wp-admin/includes/taxonomy.php

function wp_create_category( $cat_name, $parent = 0 ) {
	$id = category_exists( $cat_name, $parent );
	if ( $id ) {
		return $id;
	}

	return wp_insert_category(
		array(
			'cat_name'        => $cat_name,
			'category_parent' => $parent,
		)
	);
}

Top ↑

Changelog Changelog

Changelog
Version Description
2.0.0 Introduced.


Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    Contributed by Codex

    Examples

    In order to create a simple category use:

     wp_create_category( 'My category name' );
    

    To create a category that is a child of Uncategorized (or whatever category has the ID 0), use:

    wp_create_category( 'Child of Uncategorized', 0 );
    

    To get id of category created and put value in variable:

    $id = wp_create_category( 'Child of Uncategorized', 0 );
    

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