跳到主要內容

JSON-LD 格式JavaScript Object Notation for Linked Data (JSON-LD)

JSON-LD 格式是用 JSON 描述可互相連結資料的格式,網頁用它說明名稱、類型、屬性,以及不同對象之間的關係。

英文
JavaScript Object Notation for Linked Data (JSON-LD)
台灣常見別名
JSON-LD、連結資料的 JSON 格式
簡中用語
链接数据 JSON 格式
類別
技術SEO
提出者與年份
W3C JSON-LD 工作小組;1.0 於 2014 年 1 月 16 日、1.1 於 2020 年 7 月 16 日成為 W3C 建議標準
官方文件
Google 搜尋中的結構化資料標記簡介

JSON-LD 格式是什麼?

JSON-LD 的全名是 JavaScript Object Notation for Linked Data,意思是「用 JSON 表示的連結資料」。它是一種資料格式:用大括號與「名稱:值」的方式,寫出一個對象是什麼類型、有哪些屬性。網頁放進一段 JSON-LD,機器不需要讀懂版面,就能知道這頁在講哪家公司、哪個商品、哪位作者。

它發生在網站把頁面內容整理成結構化資料的那一步。W3C 在 2014 年 1 月 16 日發布 JSON-LD 1.0 建議標準,2020 年 7 月 16 日發布 1.1。JSON-LD 只決定格式,欄位名稱通常用 Schema.org 這類詞彙。Google 支援 JSON-LD、Microdata、RDFa 三種格式,並建議在環境允許時優先用 JSON-LD。

舉例

一個藝文網站的展覽頁面上顯示了機構名稱、展覽網址與展覽日期。網站在頁面放一段 JSON-LD,把這些資料寫成 Event 與 Organization,搜尋引擎就能直接讀出名稱與日期,不必從段落文字猜。

JSON-LD 格式怎麼寫

JSON-LD 放在 script 標籤裡,type 設為 application/ld+json。下面是一篇文章的基本寫法:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "JSON-LD 是什麼",
  "datePublished": "2026-11-20",
  "author": { "@type": "Person", "name": "AK" }
}
</script>

@context 指定詞彙來源,@type 指定類型,其餘是該類型的屬性。常見的類型與用途如下:

類型用途
Article、BlogPosting文章的標題、作者、發布日期
Organization公司名稱、標誌、官方社群
Product、Offer商品名稱、識別碼、價格
BreadcrumbList麵包屑路徑
LocalBusiness在地商家的地址與營業時間

正確寫法

標記的內容在頁面上看得到,括號與逗號完整,引號是直引號。

錯誤寫法

最後一個屬性後面多一個逗號、用了中文彎引號,或漏掉 @context。另一種錯誤是標記頁面上沒有的資料,Google 文件要求標記的內容必須是使用者看得到的。

為什麼重要

Google 的結構化資料政策要求標記內容與頁面可見內容相符,Google 是否顯示對應的搜尋功能,還要看類型、頁面能否被讀取,以及是否符合政策。JSON-LD 本身不保證出現特殊搜尋結果,但它是讓搜尋引擎穩定讀懂頁面實體的方式。因為它獨立於 HTML 版面,維護與批次產生都比 Microdata 簡單。

怎麼檢查

  1. 用 Google 的 Rich Results Test 貼上網址,看標記是否被讀到、有沒有錯誤或警告。
  2. 用 Schema Markup Validator 檢查語法與屬性是否符合 Schema.org。
  3. 上線後到 Search Console 的「增強功能」報表,看各類型標記的有效與錯誤數量。
  4. 用瀏覽器檢視原始碼,確認 JSON-LD 的內容和頁面上看得到的文字一致。

常見誤解

  • JSON-LD 是 Google 的專屬格式。

    它是 W3C 的開放標準,Google 只是支援並推薦它。

  • 加了 JSON-LD 就會出現特殊搜尋結果。

    標記只是資格條件之一,還要符合各功能的規定與政策。

常見問題

JSON-LD 要放在 head 還是 body?

兩個位置 Google 都能讀。通常放在 head 的 script 標籤內,網站外掛與 CMS 也多半輸出在 head。重點不在位置,而是標記描述的內容必須是頁面上看得到的內容。

Google 為什麼建議用 JSON-LD,不用 Microdata?

Google 說明三種格式都可以,只要標記有效就一樣好,但如果網站環境允許,建議用 JSON-LD,因為它最容易大規模實作與維護。JSON-LD 與頁面 HTML 分開,修改時不必動到版面。

JSON-LD 寫完要怎麼驗證?

先用 Google 的 Rich Results Test 檢查語法與資格,上線後再到 Search Console 的結構化資料狀態報表,追蹤改版或模板造成的錯誤。兩邊看的角度不同,建議搭配著用。

加了 JSON-LD 就一定會出現豐富結果嗎?

不會。結構化資料只是讓 Google 更容易理解頁面,也是符合資格的前提,Google 不保證一定顯示豐富結果。內容品質、標記是否符合官方規範,以及該功能是否適用你的頁面,都會影響結果。

閱讀更多

AK · AKSEO Labs · 上線