HTML reference

itemscope

The Microdata itemscope attribute marks an element as the boundary of one structured-data item, such as a person, product, or article.

Basic example

<article itemscope itemtype="https://schema.org/Book">
  <h2 itemprop="name">The Web Guide</h2>
  <p itemprop="author">A. Reader</p>
</article>

itemscope starts the item. itemtype says which vocabulary type it uses, and itemprop labels the properties inside it. The visible content should still be natural and truthful for readers.

Nested items

An item can contain another item, such as a product containing an offer. Keep nesting aligned with the vocabulary's model; adding attributes does not automatically make search results richer.

Validation and alternatives

Validate structured data and check the documentation of the consumer that will read it. JSON-LD can be easier to maintain when annotations would make the visible HTML difficult to read.

Related pages

• itemid
• itemtype
• itemprop
• custom elements
• English HTML reference