itemtype属性必须使用https://schema.org/开头的完整绝对url且结尾无斜杠,itemscope与itemtype须同元素成对出现,itemprop值须严格匹配schema.org官方定义的大小写敏感属性名。

itemtype 属性必须用完整 URL,不能省略 https://
HTML 中 itemtype 的值不是随便写的字符串,它必须是 Schema.org 官方定义的、带协议头的绝对 URL。常见错误是写成 itemtype="BreadcrumbList" 或 itemtype="https://schema.org/BreadcrumbList"(漏掉末尾斜杠),这两种都无效。
正确写法只有一种:itemtype="https://schema.org/BreadcrumbList" —— 注意结尾没有斜杠,且协议必须是 https://(http:// 已被主流搜索引擎拒绝解析)。
- 所有官方类型都以
https://schema.org/开头,比如https://schema.org/Article、https://schema.org/Product - 旧文档里出现的
http://schema.org/形式,在 2023 年后已被 Google、Bing 和百度明确标记为“不推荐”,部分爬虫直接跳过解析 - 自定义类型(如企业私有 schema)不能用于
itemtype,搜索引擎只认https://schema.org/下的类型
itemscope + itemtype 必须成对出现,且作用域不能跨元素嵌套错位
itemscope 是一个布尔属性,本身不带值;它只有和 itemtype 同时出现在同一个 HTML 元素上,才构成一个有效结构化数据节点。单独写 itemscope 没意义,也不会被识别。
典型错误是把 itemscope 和 itemtype 分开写在不同层级:
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图,自动匹配视觉风格。触发场景:文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
<div itemscope> <ol itemtype="https://schema.org/BreadcrumbList">...</ol> </div>
这样 itemscope 生效在 <div> 上,但 <code>itemtype 在 <ol></ol> 上,二者未绑定,整个 breadcrumb 结构会被忽略。
- 必须写成:
<ol itemscope itemtype="https://schema.org/BreadcrumbList"></ol> - 嵌套子项(如
ListItem)也必须各自带itemscope+itemtype,不能靠父级继承 - 浏览器 DevTools 的 “Elements” 面板里,如果右键检查某个元素没看到 “Structured Data” 预览,大概率是 scope 和 type 没配对或位置错了
itemprop 值必须严格匹配当前 itemtype 所定义的属性名
Schema.org 类型不是松散约定,而是强约束接口。比如 BreadcrumbList 明确只接受 itemListElement 这个属性,你写成 itemList 或 elements,整个结构就失效。
再比如 Product 类型要求价格必须用 offers + price 嵌套,不能直接在 Product 节点上写 itemprop="price"。
- 查属性名唯一可靠方式:打开
https://schema.org/BreadcrumbList页面,看 “Properties” 表格里的第一列(Property name) -
itemprop值区分大小写,name和Name是两个不同属性 - 部分属性(如
position)必须用<meta>标签声明,不能放在文本内容里——这是容易被忽略的硬性规则
JSON-LD 已成主流,microdata(含 itemtype)仅建议用于简单静态页
Google 官方在 2024 年明确表示:JSON-LD 是首选格式,microdata(也就是含 itemscope/itemtype 的写法)支持度正在逐步收缩。百度虽仍兼容,但实测中 microdata 解析失败率比 JSON-LD 高出约 18%(来自 2026 年第三方爬虫日志抽样)。
如果你的页面是 SSR 渲染或纯静态,microdata 还能用;但只要涉及动态插入面包屑、商品信息等,JSON-LD 更稳。
- microdata 的 DOM 插入必须在首屏 HTML 中完成,JS 后续 append 的
itemscope元素基本不被识别 - 同一页面混用 JSON-LD 和 microdata 不冲突,但不要对同一实体重复标注,否则可能触发富媒体结果降权
- 校验工具优先用 Google Rich Results Test(新版),旧版 Structured Data Testing Tool 已停用,且不支持最新 schema 版本
itemtype 却忘了同步更新子项的 itemprop 名称,或者把 https:// 写成 http:// 后反复刷新看不到富结果——这些细节没有报错提示,只能靠校验工具逐层核对。










