itemtype必须与itemscope成对出现在同一元素上,且值为https://schema.org/下大小写敏感、无尾斜杠的完整HTTPS URL;格式错误、缺itemscope或类型不匹配均导致整块微数据被搜索引擎静默丢弃。

itemtype 不是独立可用的属性,它必须和 itemscope 成对出现在同一个 HTML 元素上,且值必须是 https://schema.org/ 下某个具体类型的完整 HTTPS URL;写错格式、漏掉 itemscope 或类型不匹配,整块结构化数据都会被搜索引擎静默丢弃。
itemtype 必须和 itemscope 写在同一元素上
这是硬性语法要求,不是风格建议。分离写法等于没写。
- ✅ 正确:
<div itemscope itemtype="https://schema.org/Article"></div> - ❌ 错误:
<div itemscope><section itemtype="https://schema.org/Article"></section></div>——itemtype没绑定到作用域起点 - ❌ 更隐蔽的错误:
<div itemtype="https://schema.org/Book"></div>—— 缺itemscope,整个块被忽略
常见新手误以为“加了 itemtype 就算标记成功”,结果在 Google Rich Results Test 里显示“No structured data detected”,90% 是这里出问题。
itemtype 的值必须是完整、大小写敏感的 HTTPS URL
不能省略协议,不能用 HTTP,不能多斜杠,不能小写首字母,不能是相对路径。
- ✅ 合法:
https://schema.org/Movie、https://schema.org/Restaurant - ❌ 全部失效:
http://schema.org/Movie、schema.org/Movie、https://schema.org/movie、https://schema.org/Movie/、//schema.org/Movie
2026 年起,Google 已完全停用 http://data-vocabulary.org/,任何以该域开头的 itemtype 都无效。验证时哪怕 URL 末尾多一个空格,解析器也会直接跳过整块。
立即学习“前端免费学习笔记(深入)”;
使用 PptxGenJS 和 Python 解析,将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint(.pptx)演示文稿。
选错 itemtype 类型会导致 itemprop 失效
itemprop 的合法性取决于外层 itemtype。类型不匹配,字段就被无视。
- 用
https://schema.org/Event却写itemprop="telephone"→ Google 直接忽略,因为Event类型根本不定义telephone - 用
https://schema.org/LocalBusiness却只填name,不嵌套address实体 → 地址字段解析为空,地图卡片无法触发 - 广播单期节目必须用
https://schema.org/RadioEpisode,写成RadioProgram→ 播放卡片不出现,Search Console 报Invalid itemtype
查类型要直击 schema.org 对应页面底部 “More specific Types” 或顶部 “Type hierarchy”,别从首页瞎搜——首页跳转常带重定向、多余斜杠或协议错误。
嵌套复杂属性时,itemtype 不能省略
地址、作者、评论者这类本身就是实体的字段,必须显式声明子级 itemscope 和对应 itemtype。
- ✅ 正确:
<div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">建国路88号</div> - ❌ 错误:
<div itemprop="address">建国路88号</div>——address是对象,不是字符串,不声明类型 = 无结构 - ❌ 错误:
<div itemprop="author"><span itemscope itemtype="https://schema.org/Person">张三</span></div>——itemprop="author"没绑定到任何itemscope容器
最容易被忽略的是 postalCode 和 addressCountry:国内 LocalBusiness 标记中漏掉这两项,地图定位常偏移,甚至完全不显示营业地点。


















