WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

Function Reference/wp create category

Contents

Description

This function adds a "simple" category by specifying a category name and (optionally) a category parent.

Usage

<?php wp_create_category$cat_name$parent ); ?>

Parameters

$cat_name
(string) (required) Name for the new category.
Default: None
$parent
(integer) (optional) Category ID of the parent category.
Default: None

Return Values

(integer) 
0 on failure, category id on success.

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);

Notes

  • wp_create_category() is a thin wrapper around wp_insert_category().
  • Because this is a wrapper, it is not suitable for entering a complex custom taxonomy element.
  • If the category already exists, it is not duplicated. The ID of the original existing category is returned without error.

Source File

wp_create_category() is located in wp-admin/includes/taxonomy.php.

Related

See also index of Function Reference and index of Template Tags.