Amazonで商品を見る セール会場へ

SWELL│構造化データを追加・上書きする方法

SWELL 2.19.0が出力する組織名を変更する例を紹介します。

前半のJSONは記述例であり、固有名・URLをそのままコピーするためのコードではありません。

PHP例は子テーマのfunctions.phpまたはPHPスニペットのどちらか一方へ追加し、親テーマは編集しません。

元に戻すときは追加したフィルターだけを外します。

SEO対策のためにWordPressに構造化データを追加したい。

構造化データは、ページで扱う組織・人物・記事などの情報を、検索エンジンが解釈できる形式で記述するものです。

構造化データには、ページに表示している運営者・著者情報と一致する内容を記載します。

OrganizationやPersonを追加するだけで検索順位や評価が上がるとは限りません。

本記事ではSWELLでの構造化データの設置方法に関して、具体的なコードを記載してわかりやすく解説します。

JSON-LD形式の記述はテーマ共通ですが、後半のswell_json_ld__フィルターはSWELL専用です。

他のテーマではそのまま動きません。

構造化データの全体(出力される場所・調べ方・2026年に入れる型)はWordPressの構造化データにまとめました。

目次

著者

WEB制作をしているデジタルノマド
WordPressのカスタマイズが好きで、色々と自作しています。

WordPressのカスタマイズに困ったらご相談ください!

WordPressテーマの構造化データを調べる方法

ページの構造化データ全体は、Schema Markup Validatorで調べます。

公開URLまたはページソースを入力し、種類・項目・値を確認します。

Googleの検索機能に対応するデータを確認するときは、リッチリザルトテストを使います。

全種類の構造化データを一覧する用途とは分けます。

URL検査で新しい値が見えないときは、ログアウト状態のページソースを確認し、必要に応じてそのページのWordPress・WP Rocket・サーバー/CDNのキャッシュを更新します。

データが読めることと、検索結果で採用されることは別です。

WordPressの構造化データ(JSON-LD)

SWELLが生成する構造化データを、ページソース全体で確認します。

出力される型と設定の関係はSWELLの構造化データ一覧を参照してください。

既存の運営者・著者情報がある場合は、同じ情報を重複追加しないでください。

構造化データの種類一覧

ちなみに構造化データの種類は下記のサイトにまとまっています。

スポンサーリンク

SWELLで構造化データに関係する入力箇所

ユーザー > プロフィールに入力する場所も重要です。

著者データには投稿者本人の名前・URL・SNSを設定します。

2026年10月11日に確認したユーザープロフィール画面では、author構造化データのurl欄で著者を表すURLを設定します。

Personを指定した投稿者に無関係な企業URLを入れる欄ではありません。

組織として記事を書く場合は、実際の著者に合わせて種別と各項目を設定してください。

現行画面の「呼び出すブログパーツのID」でブログパーツを指定する機能と、JSON-LDの著者URLの設定は別です。

ブログパーツIDを指定しただけで、JSON-LDのurlがその紹介ページへ変わるとは限りません。

SWELL 2.19.0の著者urlは、構造化データ用URL、WordPressユーザーのサイトURL、サイトのホームURLの順で決まります。

ページソースのArticle内のauthorを確認し、意図した著者情報になっているか調べます。

著者ページに出る構造化データと、著者の url を著者ページと結びつける手順は、SWELL│テーマで出力される構造化データ一覧にまとめています。

著者紹介ページのブログパーツIDを入力して関連付ける設定画面。
この記事で紹介する内容
  • Organizationの構造化データ
  • Personの構造化
  • 既存の構造化データを上書きする方法

共通データの変更前後を比較する

スクロールできます
確認箇所組織名フィルター適用後元へ戻した後
Organizationのname指定した運営者名変更前の名前
Organizationの@id変更前の@idを維持変更前の@id
Articleのpublisher同じOrganizationの@idを参照同じ参照を維持
WebSite・WebPage・BreadcrumbList変更前のデータを維持変更前のデータ

後半の組織名の例を、SWELL 2.19.0が実際に生成する共通JSON-LDで確認しました。

変わったのはOrganizationのnameだけで、フィルターを外すと元のデータへ戻ります。

設定画面で入力できる情報は先に設定を使い、同じ運営者のJSON-LDを別途追加する必要があるか確認してください。

共通JSON-LDはfooterで出力されます。

ページソース全体で「JSON-LD @SWELL」を探して比較します。

以下のJSON例を使う場合は自分の運営者・著者情報へ置き換え、既存のOrganizationやPersonと重複させないでください。

SWELLで構造化データを追加する方法

では早速、Googleに伝えるための情報、構造化データ(JSON-LD)を作成してテーマに入れてみましょう。

以下の手順に添えた画面は2021年2月から2022年4月に撮影したもので、生成ツールとSWELLの設定画面は現在と異なります。

項目の位置は各画面の現行表示で確認してください。

STEP
構造化データの作成

下記のサイトを使うと構造化データの入力が捗ります。

このツールで作成できる構造化データには次の種類があります。

ツール側の更新で増減するため、最新の一覧はツールの画面で確認してください。

  1. Article
  2. Breadcrumb
  3. Event
  4. FAQ Page
  5. How-to
  6. Job Posting
  7. Local Business
  8. Organization
  9. Person
  10. Product

今回は「Organization(組織)」「Person(個人)」を作成してみましょう。

組織や個人の構造化データを作成する手順の説明。

以下は過去に使用した情報を含む記述例です。

現在のプロフィールやSNSの確認済み一覧ではありません。

PersonのsameAsにはその本人を表すURLだけを指定し、組織のアカウントを本人のものとして流用しないでください。

不要な項目や確認できないURLは省きます。

Organizationの構造化データ例

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "CGメソッド",
  "alternateName": "CG-Method",
  "url": "https://www.cg-method.com/",
  "logo": "https://www.cg-method.com/wp-content/uploads/2020/08/CG_METHOD_NEPTUNE_White_LOGO.png",
  "sameAs": [
    "https://www.facebook.com/cg.meth0d/",
    "https://twitter.com/cg_method",
    "https://www.instagram.com/optimizer_life/?hl=ja",
    "https://www.youtube.com/channel/UCqRExSeEm8n1w_oO0OzjXHA/",
    "https://www.pinterest.jp/cg_method/",
    "https://gist.github.com/cg-method",
    "https://www.cg-method.com/"
  ]
}
</script>

Personの構造化データ例

<script type="application/ld+json">
{
  "@context": "https://schema.org/",
  "@type": "Person",
  "name": "suimin",
  "url": "https://www.cg-method.com/",
  "image": "https://www.cg-method.com/wp-content/uploads/2020/08/CG_METHOD_NEPTUNE_White_LOGO.png",
  "sameAs": [
    "https://www.facebook.com/cg.meth0d/",
    "https://twitter.com/cg_method",
    "https://www.instagram.com/optimizer_life/?hl=ja",
    "https://www.youtube.com/channel/UCqRExSeEm8n1w_oO0OzjXHA/",
    "https://www.pinterest.jp/cg_method/",
    "https://gist.github.com/cg-method",
    "https://www.cg-method.com/"
  ],
  "jobTitle": "designer",
  "worksFor": {
    "@type": "Organization",
    "name": "MOTOKI合同会社"
  }  
}
</script>
STEP
WordPressに作成した構造化データを入れる

追加前に既存のJSON-LDを確認し、対象ページの内容に必要なデータだけを選びます。

既存データの値を直すだけなら、後半のフィルター例を検討してください。

全ページに構造化データを入れたい場合

サイト共通で同じ情報を出す必要があり、既存データと重複しない場合に限り、SWELLのカスタマイズから高度な設定>headタグ終了直前に出力するコードにHTMLをコピペしましょう。

カスタマイズの高度な設定からheadタグ終了直前にコードを出力する設定画面。

記事単位で入れる場合

記事編集画面を開く、一番下にカスタムHTMLのブロックを作成して、そこにHTMLのコードを入れてみましょう!

記事編集画面の一番下にカスタムHTMLブロックを作成してコードを入力する様子。
STEP
構造化データの確認

もう一度、スキーマ マークアップ検証ツールで調べてみましょう。

掲載画像は過去の検出例です。

導入先の公開URLで、追加した型が検出されるか確認してください。

テストツールで追加した構造化データが検出された確認画面。

検出の有無だけでなく、名前・URL・同一人物を表すリンク・既存データとの重複を確認します。

構文エラーがないことは、内容の正確さや検索結果への採用を保証しません。

テストツールで構造化データの中身が正しく入っていることを確認する画面。
SWELLで構造化データを追加や上書きする手順の解説イメージ。

SWELLで既存の構造化データを修正する方法

JSON-LDの上書き方法

SWELL専用のフィルターを使うと、テーマのファイルを直接編集せずに出力する値を上書きできます。

子テーマのfunctions.phpへ次のフィルターを追加すると、Organizationのnameを上書きします。

add_filter( 'swell_json_ld__organization', function( $data ) {
	$data['name'] = 'CGメソッド';
	return $data;
} );

SWELL 2.19.0ではArticleのpublisherはOrganizationの@idを参照します。

この例では参照先のOrganizationのnameを変更します。

実在する運営者名へ置き換え、SWELL設定との重複にも注意してください。

構造化のチェック方法はSchema.orgから調べましょう。

Schema.orgで構造化データをチェックする方法。

もう一つ例を書いておきます。

下記はウェブサイトの構造化データのサイト名を上書きします。

add_filter( 'swell_json_ld__website', function( $data ) {
    $data['name'] = 'サイト名';
    return $data;
} );
スポンサーリンク

まとめ

本記事ではSWELLでの構造化データを追加・上書きする方法について書きました。

まずSWELLが出力する情報を確認し、実際の運営者・著者と異なる項目や不足だけを修正します。

追加するデータは本文の内容と一致させ、Googleの構造化データガイドラインと対象となる型の要件も確認してください。

よくある質問:SWELLで構造化データを追加・上書きするとき

構造化データを追加すると、検索順位は上がりますか?

順位向上を保証するものではありません。

ページに表示している運営者・著者情報と一致させてください。

正しい記述でも、検索結果の特別な表示に採用されるとは限りません。

記事の後半のswell_json_ld__フィルターは他のテーマでも使えますか?

そのままでは使えません。

JSON-LDの形式はテーマ共通ですが、SWELL専用フィルターの呼び出しがないテーマでは、その登録だけで出力は変わりません。

構造化データは、どうやって確認しますか?

ページの構造化データ全体は、Schema Markup Validatorで調べます。

Googleの検索機能に対応するデータを確認するときはリッチリザルトテストを使い、全種類の構造化データを一覧する用途とは分けます。

URL検査で新しい値が見えないときは、ログアウト状態のページソースを確認し、必要に応じてWordPress・WP Rocket・サーバー/CDNのキャッシュを更新します。

全ページに入れるか、記事ごとに入れるかは、どう選びますか?

データが説明する内容とページの範囲で選びます。

特定の記事・人物・イベントの情報は、それを扱うページへ配置します。

全ページ共通の欄へ入れる前に、各ページとの関連性とSWELLの既存出力を確認してください。

配置後は公開ページのソースで重複と値を調べます。

掲載のJSON例は、そのままコピーして使えますか?

使えません。

前半のJSONは過去の情報を含む記述例です。

自分の運営者・著者情報へ置き換え、既存のOrganizationやPersonと重複させないでください。

SWELLの既存の構造化データを上書きするには?

SWELL専用のフィルターを使います。

子テーマのfunctions.phpへフィルターを追加すると、テーマのファイルを直接編集せずにOrganizationのnameを上書きできます。

実在する運営者名へ置き換え、SWELL設定との重複にも注意してください。

元に戻すときは追加したフィルターだけを外します。

著者のurlは、どう決まりますか?

SWELL 2.19.0の著者urlは、構造化データ用URL、WordPressユーザーのサイトURL、サイトのホームURLの順で決まります。

ブログパーツIDを指定しただけで、JSON-LDのurlがその紹介ページへ変わるとは限りません。

ページソースのArticle内のauthorを確認してください。

この記事の内容は、今のSWELLでもそのまま通用しますか?

掲載する検証記録の対象はSWELL 2.19.0です。

組織名のフィルターはOrganizationのnameだけを変更し、外すと元のデータへ戻ることを確認しています。

使用中のバージョンと設定でも、変更前後を比較してください。

一方、手順に添えた画面は2021年2月から2022年4月に撮影したものです。

作成できる構造化データの種類はツール側の更新で増減するため、最新の一覧はツールの画面で確認してください。

  • URLをコピーしました!

内部SEOを本格的に見直すなら

WordPressのSEO対策

内部構造の調査は¥30,000〜、継続的なSEO対策は月額 ¥50,000〜(税込・最低6ヶ月)。専任のコンサルタントが定期ミーティングで施策を進めます。

WAZAの有料記事のサブスクリプションも開始しました。

サービス

Service

WordPressサイトのSEO対策のサービスに関心がありましたら、ぜひ詳細をご覧ください。

目次