📘 公式リファレンス🔧 リファレンス/フィルター初級

structured_data フィルター（schema.org 構造化データに変換）

商品またはブログ記事オブジェクトを schema.org の構造化データ形式に変換するフィルター。バリアントがない場合は Product 型、バリアントがある場合は ProductGroup 型として出力される。

用途

商品ページやブログ記事ページに JSON-LD を埋め込み、Google 検索結果のリッチリザルト（商品価格・在庫・記事日付など）を表示させるときに使う。

設置場所

product テンプレートまたは article テンプレートの `<head>` 内に `<script type="application/ld+json">{{ product | structured_data }}</script>` または `<script type="application/ld+json">{{ article | structured_data }}</script>` の形で記述する。

注意点

product オブジェクトの場合、バリアント有無で自動的に ProductGroup と Product が切り替わるため、手動での型指定は不要。article オブジェクトは常に Article 型で出力される。出力されるデータは article の published_at / image / author などメタフィールドの有無に依存するため、Shopify 管理画面で必須情報を埋めておくことが前提となる。

タグ:json-ldschema-orgproductarticleseo

仕様

30 行 / json

{
  "category": "format",
  "deprecated": false,
  "deprecation_reason": "",
  "description": "The `structured_data` filter can be used on the [`product`](/docs/api/liquid/objects/product) and [`article`](/docs/api/liquid/objects/article) objects.\n\nProduct objects are output as a [schema.org `Product`](https://schema.org/Product) if they have no variants, and a [`ProductGroup`](https://schema.org/ProductGroup) if they have one or more variants.\n\nArticle objects are output as a [schema.org `Article`.](https://schema.org/Article)",
  "parameters": [],
  "return_type": [
    {
      "type": "string",
      "name": "",
      "description": "",
      "array_value": ""
    }
  ],
  "examples": [
    {
      "name": "",
      "description": "",
      "syntax": "",
      "path": "/products/crocodile-tears",
      "raw_liquid": "&lt;script type=\"application/ld+json\"&gt;\n  {{ product | structured_data }}\n&lt;/script&gt;",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": true
    }
  ],
  "summary": "Converts an object into a schema.org structured data format.",
  "syntax": "variable | structured_data",
  "name": "structured_data"
}

出典・ライセンス

Source:: Shopify/theme-liquid-docs/data/filters.json
Repository:: https://github.com/Shopify/theme-liquid-docs
License:: MIT

このコードは Shopify 著作の MIT ライセンスソースです。原本の著作権は Shopify が保有します。日本語訳は ALSEL によるものです。

structured_data フィルター（schema.org 構造化データに変換）

仕様

出典・ライセンス

関連項目

avatar フィルター（顧客アバター画像HTML生成）

default_errors フィルター（フォーム送信エラーを日本語化）

date フィルター（日付を指定形式でフォーマット）

payment_terms フィルター（Shop Pay分割払いバナーを生成）

abs フィルター（数値の絶対値を取得）

append フィルター（文字列の末尾に追加）