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 簡單。
怎麼檢查
- 用 Google 的 Rich Results Test 貼上網址,看標記是否被讀到、有沒有錯誤或警告。
- 用 Schema Markup Validator 檢查語法與屬性是否符合 Schema.org。
- 上線後到 Search Console 的「增強功能」報表,看各類型標記的有效與錯誤數量。
- 用瀏覽器檢視原始碼,確認 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 不保證一定顯示豐富結果。內容品質、標記是否符合官方規範,以及該功能是否適用你的頁面,都會影響結果。
閱讀更多
- Schema 結構化資料完整教學:選型、JSON-LD 實作與三層驗證
長文用常見 Schema 類型和範例拆解 JSON-LD 欄位,並示範格式、Google 資格和實際頁面三層驗證。