itemref (attribute)

The global attribute itemref Properties that are not descendants of an element with the itemscope attribute can be associated with the item using an itemref. itemref provides a list of element id's (not itemids) with additional properties elsewhere in the document.

The itemref attribute can only be specified on elements that have an itemscope attribute specified.

Note: the itemref attribute is not part of the microdata data model. It is merely a syntactic construct to aid authors in adding annotations to pages where the data to be annotated does not follow a convenient tree structure. For example, it allows authors to mark up data in a table so that each column defines a separate item while keeping the properties in the cells.

Example

HTML

<div itemscope id="amanda" itemref="a b"></div>
<p id="a">Name: <span itemprop="name">Amanda</span> </p>
<div id="b" itemprop="band" itemscope itemref="c"></div>
<div id="c">
    <p>Band: <span itemprop="name">Jazz Band</span> </p>
    <p>Size: <span itemprop="size">12</span> players</p>
</div>

Structured data

id's	itemscope	itemref		(itemprop name)	(itemprop value)
id=amanda	itemscope	itemref=a,b
id=a			itemprop	name	Amanda
id=b	itemscope	itemref=c		band
id=c			itemprop	Band	Jazz Band
			itemprop	Size	12

Result

Specifications

Specification	Status	Comment
itemref		WG Note - No longer being actively developed

Browser compatibility

See also

• Other different global attributes
• Other, microdata related, global attributes:
  • itemid
  • itemprop
  • itemref
  • itemscope
  • itemtype