itemtype必须是完整、合法、无斜杠的https url,如https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937product;写成缩写、相对路径、http协议、末尾带斜杠或非schema.org地址均导致整块微数据失效。

itemtype 必须是完整、合法、无斜杠的 HTTPS URL,否则结构化数据直接失效。
itemtype 值必须是 https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937 开头的完整 URL
它不是类名,不是缩写,也不是相对路径。写成 itemtype="Product"、itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Product/"(末尾斜杠)、itemtype="http://schema.org/Product"(HTTP 协议)或 itemtype="//schema.org/Product" 都会被 Google Rich Results Test 报错并忽略整块微数据。
正确写法只有一种形式:itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Product"。必须严格匹配 schema.org 官方页面路径,大小写敏感,且不能多字符、少字符、换顺序。
- 查类型前,先去 https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937 搜索你要标记的主体(比如 “Article”、“LocalBusiness”、“Person”)
- 点进对应类型页,URL 栏里显示的就是标准
itemtype值,复制即可 - 注意:2026 年起,Google 已完全停用
http://data-vocabulary.org/,所有旧地址全部失效
itemscope 和 itemtype 必须出现在同一个 HTML 元素上
不能拆开写,比如把 itemscope 放在 <div>,再把 <code>itemtype 写在子元素里——这样解析器根本认不出这是一个实体。
常见错误写法:<div itemscope><section itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Event">...</section></div>
这等同于没声明类型,整个 itemscope 块被丢弃。
- 正确写法只能是:
<div itemscope itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Event">...</div> - 推荐复用语义化容器标签,比如
<article itemscope itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Article"></article>,既符合 HTML5 规范,又避免嵌套冗余 - 一个元素可以同时有多个
itemtype(用空格分隔),但实际极少需要;优先选最贴合页面主体的那个
选错 itemtype 类型会导致富摘要不触发
不是“越具体越好”,而是“越匹配主体越好”。比如企业介绍页硬套 https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Product,测试工具会提示 “itemtype does not match main content”,Google 也不会展示公司卡片。
- 问自己:用户打开这个页面,核心想看的是什么?是人(
Person)、组织(Organization)、文章(Article),还是事件(Event)? - 查 schema.org 对应类型的 “Properties” 表格,确认你页面里真有它要求的关键字段(比如
LocalBusiness要有address和telephone) - 避免跨域混用:比如在
Product容器里直接塞itemprop="author"——author不是Product的合法属性,得查文档确认
itemtype 声明后必须配合 itemprop 才有意义
itemscope itemtype="https://www.php.cn/link/b8eadb229854b2add23d0371cc31b937Recipe" 这行代码本身不携带任何字段信息。它只是划出一块“这是个菜谱”,但没说菜名、食材、步骤——这些全靠内部 itemprop 绑定。
测试时如果 Rich Results Test 显示 “0 properties found”,第一反应不是 itemtype 错了,而是检查有没有漏掉 itemprop,或者 itemprop 值拼写错误(比如 "recipename" 而不是官方定义的 "name")。
-
itemprop的值必须来自 schema.org 对应类型的 Properties 列表,大小写严格一致 - 文本内容默认取
textContent,不是alt、value或href——想传链接地址,得用<a itemprop="url" href="..."></a> - 日期、价格、评分等机器可读字段,必须用
<time datetime="..."></time>、<data value="..."></data>或<meta content="...">显式提供结构化值
最容易被忽略的是:itemtype 不是“设完就完事”的开关,它和 itemprop 是绑定关系,缺一不可;而它的 URL 格式、协议、路径、结尾斜杠,任何一个字符错,整块语义就归零——连带所有子属性一起失效。











