Stay organized with collections
Save and categorize content based on your preferences.
Microdata
is a specification to embed machine-readable data in HTML documents. Microdata consists of name-value pairs (known as items) defined according to a vocabulary. A collection of commonly used markup vocabularies are provided by schema.org.
The basic syntax includes the itemscope attribute to define an item and the itemprop attribute to describe one of the item's properties. Types are specified using the itemtype attribute and can assume values defined in the vocabulary of choice. For instance, schema.org defines types such as http://schema.org/Person or http://schema.org/PostalAddress.
The following example (from Wikipedia) shows how to use microdata to describe a person:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-18 UTC."],[],[],null,["[Microdata](https://html.spec.whatwg.org/multipage/microdata.html#microdata)\nis a specification to embed machine-readable data in HTML documents. Microdata consists of name-value pairs (known as `items`) defined according to a vocabulary. A collection of commonly used markup vocabularies are provided by [schema.org](https://schema.org/).\n\nThe basic syntax includes the `itemscope` attribute to define an item and the `itemprop` attribute to describe one of the item's properties. Types are specified using the `itemtype` attribute and can assume values defined in the vocabulary of choice. For instance, `schema.org` defines types such as `http://schema.org/Person` or `http://schema.org/PostalAddress`.\n\nThe following example (from [Wikipedia](http://en.wikipedia.org/wiki/Microdata_(HTML)#Example)) shows how to use microdata to describe a person: \n\n \u003csection itemscope itemtype=\"http://schema.org/Person\"\u003e\n Hello, my name is\n \u003cspan itemprop=\"name\"\u003eJohn Doe\u003c/span\u003e,\n I am a\n \u003cspan itemprop=\"jobTitle\"\u003eGraduate research assistant\u003c/span\u003e\n at the\n \u003cspan itemprop=\"affiliation\"\u003eUniversity of Dreams\u003c/span\u003e\n My friends call me\n \u003cspan itemprop=\"additionalName\"\u003eJohnny\u003c/span\u003e\n You can visit my homepage at\n \u003ca href=\"http://www.example.com.com\" itemprop=\"url\"\u003ewww.example.com\u003c/a\u003e\n \u003csection itemprop=\"address\" itemscope itemtype=\"http://schema.org/PostalAddress\"\u003e\n I live at\n \u003cspan itemprop=\"streetAddress\"\u003e1234 Peach Drive\u003c/span\u003e\n \u003cspan itemprop=\"addressLocality\"\u003eWarner Robins\u003c/span\u003e\n \u003cspan itemprop=\"addressRegion\"\u003eGeorgia\u003c/span\u003e.\n \u003c/section\u003e\n \u003c/section\u003e\n\nCheck the [Schema Validator](/workspace/gmail/markup/testing-your-schema#schema_validator) tool to debug your markup and validate it against the supported schema."]]