HTML itemtype 仅支持 Schema.org 的 HTTPS URL,如 https://schema.org/Person;不接受自定义协议、本地路径或别名,即使返回200也不被解析器识别。

HTML itemtype 不支持自定义命名空间
itemtype 的值只能是外部可验证的、标准化的词汇表 URL,比如 https://schema.org/Person。它不接受任何自定义协议、本地路径、别名或你自己搭建的 schema 服务地址——哪怕那个地址返回 200 状态码且内容结构合法,主流解析器(Google、Bing、Yandex)也直接跳过。
常见错误包括:itemtype="https://myapp.com/schema/User"、itemtype="custom:Product"、itemtype="/schema/Event"。这些写法在 Google Rich Results Test 里不会报错,但也不会生成任何结构化数据。
- Schema.org 是事实标准,所有支持微数据的工具链都只认它的 HTTPS URL
- data-vocabulary.org 已于 2020 年弃用,
http://data-vocabulary.org/Person不再被 Google 识别 - 即使你用 JSON-LD 实现了自定义类型,HTML 微数据层的
itemtype仍不能映射过去
想表达非标准实体,只能降级用通用类型
如果你要标记一个“内部工单系统里的 Ticket”,Schema.org 没有对应类型,就别硬造 URL。正确做法是选最贴近的现有类型,比如 https://schema.org/Thing 或 https://schema.org/CreativeWork,然后靠 itemprop 扩展语义(只要不违反属性定义范围)。
例如:
立即学习“前端免费学习笔记(深入)”;
<div itemscope itemtype="https://schema.org/CreativeWork"> <meta itemprop="name" content="BUG-12345"> <meta itemprop="description" content="登录页按钮点击无响应"> <meta itemprop="dateCreated" content="2026-10-13"> </div>
注意:dateCreated 是 CreativeWork 的合法属性,但 status 或 assignee 就不是——填了也不会被提取。
- 查属性是否可用,必须打开对应 Schema 页面,看「Properties」列表
- 不要依赖「看起来合理」,
itemprop="priority"在任何官方类型里都不存在 - 如果关键字段无法映射,说明微数据不适合这个场景,该换 JSON-LD
为什么 xmlns 和自定义命名空间在 HTML 里完全无效
xmlns 属性在 HTML5 文档中被浏览器静默忽略,document.documentElement.namespaceURI 永远是 null。你写 ,既不会改变元素解析行为,也不能让 <button></button> 变成合法标签,更不会影响 itemtype 解析逻辑。
有人试图用它模拟命名空间隔离,结果发现:
-
document.querySelector('myorg\:button')查不到节点 - CSS 中写
myorg:button { display: block; }不生效(除非用 XHTML MIME type 加载) - 结构化数据测试工具完全不读取 xmlns 值
真正需要命名空间的场景(如 SVG、MathML)是靠子元素自己声明,比如 <svg xmlns="http://www.w3.org/2000/svg"></svg>,和 HTML 主文档的 itemtype 无关。
嵌套时 itemtype 要独立声明,但不能乱配
嵌套结构中,每个 itemscope 都可以有自己的 itemtype,但它必须是完整、合法、大小写精确的 Schema.org URL,且与父级类型语义兼容。
例如书+作者:
<div itemscope itemtype="https://schema.org/Book">
<h1 itemprop="name">《三体》</h1>
<div itemprop="author" itemscope itemtype="https://schema.org/Person">
<span itemprop="name">刘慈欣</span>
</div>
</div>
这里第二个 itemtype 是有效的,因为它属于 author 属性值这个新 item,不是“书的子类型”。但下面这些是错的:
-
itemtype="https://schema.org/person"(小写 p,URL 无效) -
itemtype="https://schema.org/Book https://schema.org/Person"(空格分隔多类型,仅首项被识别,且 Book 和 Person 不兼容) -
itemtype="Person"(缺协议和域名,纯字符串)
最容易被忽略的是:嵌套的 itemtype 必须能通过 Schema.org 官方页面验证,而且它的 itemprop 必须属于该类型定义的属性集——不是“作者有名字”,而是“https://schema.org/Person 允许 name 这个属性”。



















