wp_create_term() – Function | Developer.WordPress.org

wp_create_term( string $tag_name, string $taxonomy = ‘post_tag’ ): array|WP_Error

Adds a new term to the database if it does not already exist.

Parameters

$tag_namestringrequired: The term name.
$taxonomystringoptional: The taxonomy within which to create the term. Default 'post_tag'.
Default:'post_tag'

Return

Source

function wp_create_term( $tag_name, $taxonomy = 'post_tag' ) {
	$id = term_exists( $tag_name, $taxonomy );
	if ( $id ) {
		return $id;
	}

	return wp_insert_term( $tag_name, $taxonomy );
}

View all references View on Trac View on GitHub

Uses	Description
wp_insert_term()`wp-includes/taxonomy.php`	Adds a new term to the database.
term_exists()`wp-includes/taxonomy.php`	Determines whether a taxonomy term exists.

Used by	Description
wp_create_tag()`wp-admin/includes/taxonomy.php`	Adds a new tag to the database if it does not already exist.

Changelog

Version	Description
2.8.0	Introduced.

User Contributed Notes

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