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

ユーザー・権限

wp_update_user() は、既存ユーザーの情報を更新する関数です。

2026.10.03

説明

wp_update_user() は、既存ユーザーの情報を更新する関数です。

wp_update_user( array|object|WP_User $userdata ): int|WP_Error

ユーザーID。失敗時は WP_Error。

wp_update_user( array(
	'ID'           => 5,
	'display_name' => '新しい表示名',
) );

ID を指定していない。更新の対象が決まらない。
user_pass に、すでにハッシュ化された値を渡している。平文を渡すと、自動でハッシュ化される。現在のハッシュと違うハッシュ値を渡すと、二重にハッシュ化される。
戻り値が WP_Error のときを、考えていない。
ログイン名（user_login）は、変更できない。

NG例

wp_update_user( array( 'user_email' => 'new@example.com' ) ); // ID がない

OK例

$result = wp_update_user( array(
	'ID'         => $user_id,
	'user_email' => 'new@example.com',
) );
if ( is_wp_error( $result ) ) {
	return;
}