itemtype必须与itemscope同标签使用,否则无效;itemprop须在itemscope内且为后代元素;嵌套实体需直接子元素绑定;优先用语义化标签而非div;url和属性名须精确无误。

itemtype 必须和 itemscope 写在同一标签上
单独写 itemtype 没有任何效果,它必须和 itemscope 绑定在同一个 HTML 元素上,比如 <article itemscope itemtype="https://schema.org/Article"></article>。漏掉任意一个,整个微数据块都会被搜索引擎忽略。
常见错误包括:
- 把
itemscope加在上,然后在深层<p></p>里写itemprop—— 层级断裂,解析失败 - 用
<div itemscope><div itemtype="..."> 拆开写 —— Google Rich Results Test 直接报“未识别结构化数据” <li>复用旧地址如 <code>http://schema.org/Article或大小写错误如https://schema.org/article—— 2026 年所有主流工具已完全拒绝这类 URL - 所有带
itemprop的元素,必须是itemscope元素的**直接子代或后代**(不能跨父级断开) - 文本内容必须对用户可见,除非是
url、image、datePublished这类支持隐式值的属性 - 数值类字段(如价格、评分)必须用
content属性提供机器可读值:<div itemprop="price" content="2999">¥2999</div> - 日期必须用
<time itemprop="datePublished" datetime="2026-10-12"></time>,不能只写“今天”或“10月12日” <article itemscope itemtype="https://schema.org/Article"></article><section itemscope itemtype="https://schema.org/FAQPage"></section><main itemscope itemtype="https://schema.org/WebPage"></main><figure itemscope itemtype="https://schema.org/ImageObject"></figure>
itemprop 只能出现在 itemscope 容器内部
itemprop 不是独立语义标签,它本质是“字段绑定指令”,必须依附于某个已声明的实体作用域。没有 itemscope + itemtype 的外层容器,itemprop="name" 就像给空气贴标签。
实操要点:
嵌套对象必须紧贴 itemprop 所在元素
当某个属性本身是另一个实体(比如作者、地址、评论者),它的 itemscope 必须作为该 itemprop 元素的**直接子元素**,中间不能插入无关包裹层。
正确写法:<div itemprop="author" itemscope itemtype="https://schema.org/Person">张三</div>
错误写法:<div itemprop="author"><div itemscope itemtype="https://schema.org/Person">张三</div></div> —— itemprop="author" 没绑定到任何 itemscope,整个嵌套块被丢弃。
地址类尤其容易出错:address 必须是 PostalAddress 类型,且需新开 itemscope:<div itemprop="address" itemscope itemtype="https://schema.org/PostalAddress">,里面再写 <code>addressLocality、postalCode 等子属性。
别用 div 硬套,优先复用语义化标签
div 虽然技术上能加 itemscope itemtype,但语义错位:它本身无含义,读屏工具和搜索引擎无法判断这段内容在页面中的角色。
应该直接用原生语义标签作容器:
注意:<nav></nav>、<time></time>、<header></header> 这类有固定 role 或内联语义的标签,不适合加 itemscope;<time></time> 本身不能当容器,它的 datetime 属性只能绑定在父级 scope 内。
itemtype URL 多一个空格、少一个字母,或 itemprop 值拼错成 "datPublished",Google Rich Results Test 都会静默跳过整块——它不报错,只当没这回事。











