Stay organized with collectionsSave and categorize content based on your preferences.
Microdatais a specification to embed machine-readable data in HTML documents. Microdata consists of name-value pairs (known asitems) defined according to a vocabulary. A collection of commonly used markup vocabularies are provided byschema.org.
The basic syntax includes theitemscopeattribute to define an item and theitempropattribute to describe one of the item's properties. Types are specified using theitemtypeattribute and can assume values defined in the vocabulary of choice. For instance,schema.orgdefines types such ashttp://schema.org/Personorhttp://schema.org/PostalAddress.
The following example (fromWikipedia) 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-28 UTC."],[],[],null,["# Microdata\n\n[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."]]
