wp_insert_term ( $term, $taxonomy, $args = array() )

  • (string) term The term name to add.
  • (string) taxonomy The taxonomy to which to add the term.
  • (array|string) args { Optional. Array or query string of arguments for inserting a term. @type string $alias_of Slug of the term to make this term an alias of. Default empty string. Accepts a term slug. @type string $description The term description. Default empty string. @type int $parent The id of the parent term. Default 0. @type string $slug The term slug to use. Default empty string. }
  • (array|WP_Error) { An array of the new term data, WP_Error otherwise. @type int $term_id The new term ID. @type int|string $term_taxonomy_id The new term taxonomy ID. Can be a numeric string. }
Defined at:


Adds a new term to the database.A non-existent term is inserted in the following sequence: 1. The term is added to the term table, then related to the taxonomy. 2. If everything is correct, several actions are fired. 3. The 'term_id_filter' is evaluated. 4. The term cache is cleaned. 5. Several more actions are fired. 6. An array is returned containing the `term_id` and `term_taxonomy_id`. If the 'slug' argument is not empty, then it is checked to see if the term is invalid. If it is not a valid, existing term, it is added and the term_id is given. If the taxonomy is hierarchical, and the 'parent' argument is not empty, the term is inserted and the term_id will be given. Error handling: If `$taxonomy` does not exist or `$term` is empty, a WP_Error object will be returned. If the term already exists on the same hierarchical level, or the term slug and name are not unique, a WP_Error object will be returned.

Related Functions

wp_insert_site, wp_insert_user, wp_insert_category, wp_insert_post, wp_list_filter

Top Google Results

User discussions

wpseek mobile