Skip to main content

itemprop-requires-itemscope

Warns about an itemprop attribute that does not contribute a property to any item.

A document must not contain any elements that have an itemprop attribute that would not be found to be a property of any of the items in that document.

Cite: HTML Living Standard §5.2.5 — Associating names with items. The itemprop attribute itself is defined in §5.2.3 — Names: the itemprop attribute.

An element belongs to an item if either of the following holds:

  • it has an ancestor element with an itemscope attribute, or
  • its id is referenced by some itemscope element's itemref token list.

❌ Examples of incorrect code for this rule

<span itemprop="name">Orphan property</span>

✅ Examples of correct code for this rule

<!-- An ancestor has itemscope -->
<div itemscope>
  <span itemprop="name">Inside an item</span>
</div>

<!-- Reachable via itemref -->
<div itemscope itemref="ref-name"></div>
<span id="ref-name" itemprop="name">Reachable via itemref</span>

Interface​

{
  "itemprop-requires-itemscope": boolean
}

Reports an itemprop that does not belong to any item.

Default Severity​

error