h-item

h-item is a simple, open format for publishing details about arbitrary items. h-item is one of several open microformat draft standards suitable for embedding data in HTML.

In practice, h-item is almost never used on its own, but rather as the p-item in an h-review if the item being reviewed cannot otherwise be represented by either an h-card, h-product, h-event, or other specific microformat.

Status

This is a Draft Specification

Participate

IRC: #microformats on Libera

Editor

Tantek Çelik (Editor)

License

Per CC0, to the extent possible under law, the editors have waived all copyright and related or neighboring rights to this work. In addition, as of 2024-11-19, the editors have made this specification available under the Open Web Foundation Agreement Version 1.0.

Example

As the only properties defined by h-item are p-name, u-url and u-photo, in practice only the root class name is ever actually required thanks to microformats-2-implied-properties. Explicit properties may be needed for unusual markup structures or to represent multiple values, e.g. multiple URLs, photos. etc..

<a class="h-item" href="http://example.org/items/1">
  <img src="http://example.org/items/1/photo.png" alt="" />
  The Item Name
</a>

Parsed JSON:

{
  "items": [
    {
      "type": [
        "h-item"
      ],
      "properties": {
        "name": [
          "The Item Name"
        ],
        "photo": [
          "http://example.org/items/1/photo.png"
        ],
        "url": [
          "http://example.org/items/1"
        ]
      }
    }
  ]
}

Properties

• p-name - item name
• u-url - permalink URL
• u-photo - photo URL

All properties are optional.

Status

h-item is a microformats.org draft specification. Public discussion on h-item takes place on h-item-feedback and the #microformats irc channel on irc.freenode.net.

Property Details

(stub, add any property explanations here)

Examples in the Wild

• … add any h-item examples you find in the wild

Validating

Main article: validators

Test and validate microformats2 markup in general with:

• https://pin13.net/mf2/ - enter your markup directly
• https://pin13.net/ - enter a URL to a page to test where it says "Microformats Parser"

Background

h-item was extracted from the classic hReview microformat as a way of referring to arbitrary reviewed items which cannot be represented by other microformats but which required a “shell” microformat due to the flat property requirement of microformats 2.

See Also

• microformats2
• h-review