itemtype必须与itemscope成对出现在同一元素上,且值为https://schema.org/下首字母大写、无尾斜杠的完整HTTPS URL;错一个字符或类型不匹配,整块微数据即被搜索引擎静默丢弃。

itemtype 属性不能“单独修改”——它必须和 itemscope 成对出现在同一个 HTML 元素上,且值必须是 schema.org 的完整 HTTPS URL。改错一个字符(比如少个 s、多条斜杠、大小写错误),整块结构化数据就会被搜索引擎静默丢弃。
itemtype 值必须是完整 HTTPS URL,不能简写或拼错
常见错误写法:itemtype="Person"、itemtype="http://schema.org/Person"、itemtype="https://schema.org/Person/"(末尾斜杠)、itemtype="https://schema.org/person"(小写)。这些全都不生效。
正确写法只有一种:itemtype="https://schema.org/Person" —— 协议必须是 https,域名必须是 schema.org,路径必须精确匹配类型名(首字母大写、无后缀、无斜杠)。
验证方法:把 URL 粘贴进浏览器地址栏,能打开 schema.org 对应页面且 HTTP 状态码为 200,才算是有效 URL。
立即学习“前端免费学习笔记(深入)”;
修改前必须确认 itemscope 是否已存在且位置正确
itemtype 不是独立属性,它依赖 itemscope 启动作用域。如果原 HTML 是:
<div itemprop="author">张三</div>
直接加 itemtype 没用,因为没 itemscope。必须改成:
<div itemscope itemtype="https://schema.org/Person" itemprop="author"><p itemprop="name">张三</p></div>
注意三点:
-
itemscope和itemtype必须在同一元素上,不能拆开 - 如果该元素是嵌套在父
itemscope内的(比如作为itemprop="author"),它仍需自己声明itemscope itemtype - 不能把
itemscope加在或全局 wrapper 上——语义会漂移,Google Rich Results Test 会报 “No structured data detected”
类型选错比不写更危险
把餐厅标成 https://schema.org/Organization 而不是 https://schema.org/Restaurant,可能导致营业时间、菜单、价格区间等字段被忽略;把电影标成 https://schema.org/Article,富摘要里就不会显示时长和评分。
修改 itemtype 时,先查 schema.org 页面底部的 “More specific Types”,确认你要描述的内容是否属于某个更具体的子类。例如:
- 本地商家 → 优先用
https://schema.org/Restaurant,而非https://schema.org/LocalBusiness - 品牌标识 → 用
https://schema.org/Brand;带注册信息的企业 → 改用https://schema.org/Organization - 攻略类内容 → 若想触发步骤式富摘要,得换用
https://schema.org/HowTo,但校验极严,缺字段直接失败
改完必须用工具验证实际解析结果
HTML 源码看着对,不代表 Google 能识别。真正关键的是 DOM 渲染后的结构化数据是否被解析器捕获。
务必用以下任一工具实测:
重点看三处:
- 是否报 “No structured data detected” —— 90% 是
itemscope缺失或itemtypeURL 格式错误 - 嵌套地址是否被识别为
PostalAddress实体,而不是纯文本 - 字段值是否对用户可见(
itemprop="name"不能藏在<meta>或 CSSdisplay:none里)
最容易被忽略的是:改了 itemtype,却忘了同步检查嵌套子元素是否也补上了对应的 itemscope itemtype,比如 address 下的 PostalAddress、author 下的 Person —— 这些漏掉,上级类型再准也没用。



















