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

テーマ・メニュー・ショートコード・ブロック

get_custom_logo() は、カスタムロゴのHTML（リンク付き画像）を返す関数です。

2026.10.03

説明

get_custom_logo() は、カスタムロゴのHTML（リンク付き画像）を返す関数です。

get_custom_logo( int $blog_id = 0 ): string

HTMLの文字列。

echo get_custom_logo();

出力ではなく、値を返す。echo し忘れる。
ロゴが未設定のとき、空文字が返る。確認せずに、枠を出力する。
画像のURLだけが、欲しいのに、これを使っている。URLは、get_theme_mod( 'custom_logo' ) でIDを取得し、wp_get_attachment_image_url() などで、取得する。

NG例

get_custom_logo(); // 返すだけで、出力されない

OK例

$logo = get_custom_logo();
if ( $logo ) {
	echo $logo;
}