term_exists() の使い方｜説明・引数・注意点

タクソノミー・ターム

term_exists() は、指定したタームが存在するかを調べる関数です。

2026.10.03

説明

term_exists() は、指定したタームが存在するかを調べる関数です。

term_exists( int|string $term, string $taxonomy = '', int $parent_term = null ): mixed

存在しなければ 0 または null。存在すればタームIDを含む配列。

if ( ! term_exists( 'news', 'category' ) ) {
	wp_insert_term( 'news', 'category' );
}

戻り値の型が、条件によって違う。タクソノミーを指定すると配列（term_id・term_taxonomy_id）、省略するとIDが返る。存在しないときは 0 や null。
戻り値を、そのままIDとして使っている。配列のときは、$result['term_id'] を使う。
$taxonomy を省略し、意図しないタクソノミーのタームに当たる。

NG例

$id = term_exists( 'important', 'news_cat' );
wp_set_post_terms( $post_id, array( $id ), 'news_cat' ); // 配列を渡している

OK例

$term = term_exists( 'important', 'news_cat' );
if ( $term ) {
	$term_id = (int) $term['term_id'];
}