Some HTML attributes belong to one particular tag. A global attribute can be written on many different HTML elements. itemref is one of them, and it helps with includes other elements as properties of a microdata item.
What itemref changes
Includes other elements as properties of a microdata item. You attach it to an opening HTML tag, usually beside other attributes.
Global does not mean the browser handles it identically on every element. Its usefulness still depends on the element, surrounding markup, accessibility requirements, and browser support.
Example in a real page
<div itemscope itemtype="https://schema.org/Person" itemref="person-name"></div>
<span id="person-name" itemprop="name">Alex Taylor</span>What to notice
Find itemref in the opening tag. Its position among other attributes does not change its meaning; the name and value (or mere presence, for boolean attributes) are what matter.
Use only when the property cannot reasonably be nested; references must point to existing IDs.
Using it in your projects
Start with the simplest HTML that works. Add this attribute when your page actually needs includes other elements as properties of a microdata item. If changing the attribute does not visibly change the page, inspect how the browser or accessibility tree uses it rather than assuming the code failed.
For example, an attribute may give information to keyboard users, screen readers, a JavaScript component, or a stylesheet without changing the appearance of text.
Mini exercise
Copy the example into a test page. Remove itemref, check the result, then restore it. Describe exactly what changed—and what stayed the same.
Common Beginner Mistakes
- Use only when the property cannot reasonably be nested; references must point to existing IDs.
- Assuming every global attribute is appropriate on every tag without checking the context.
- Using a browser hint as if it enforces security or saves data automatically.
Key Takeaways
itemref: Includes other elements as properties of a microdata item.- Use only when the property cannot reasonably be nested; references must point to existing IDs.
- Prefer clear native HTML, and test features that depend on browser support.