From Microformats Wiki
Jump to navigation Jump to search

Current Reviews Formats

This page is here for historical reasons only. Please go to review-examples, review-formats, and review-brainstorming for the latest on the topics covered by this document.


This page was contributed from Technorati Developer's Wiki: ReviewsFormats)

  • Niall Kennedy
  • Tantek Çeliik


There have been several efforts to define data formats for posting "reviews" of products, services etc. on the Web.

This page serves to document the current list of review schemas, formats, and efforts as background for the design of a simple reviews microformat. -Tantek

Notice that author appears several times in the list below, and that it sometimes refers to the author of the review, and other times to the author of the book being reviewed. A parenthetical will be used to distinguish them now.

Centralized Implementations

Insider Pages

Customer reviews of local businesses

    • author (review author)
    • rating (0 - 5 stars)
    • business name
    • review title
    • review
    • pros
    • cons
    • business category
    • business address
    • business phone number
    • business e-mail address
    • business website

    • author (book author)
    • publication date
    • title
    • description
    • rating (1 to 5 stars)
      • overall and by category
        • declared value and a maximum possible value
  • vote for or against component


Mini reviews are limited to products on some areas of the site.

  • rating (1 to 5 stars)
    • Their mini-review interface has an 'x,' but this does not mean a rating of '0,' but in their own verbiage 'Unrated.' So the interval is 1 to 5 starts, not 0 to 5 stars. --RyanKing 11:43, 18 Jan 2006 (PST)
  • ownership status ([x] I own this)
  • negative interest ([x] Not interested)


  • author (review author)
  • title
  • publication date
  • description
  • reviewed work identifier
  • reviewed work title
  • reviewed work version
    • release date
    • Volume, issue
    • edition
    • translation
  • reviewed work author(s)
  • reviewed work publisher

Consumer Reviews

  • reviewed item
  • reviewed item version
  • rating
    • overall 1-100
    • by category 1-5
  • definition list of specifications


  • author (review author)
  • publication date
  • title
  • summary ("the bottom line")
  • description
  • rating overall and by category
  • positive summary
  • negative summary
  • cost
  • vote for or against product
  • vote for or against review

Web site or page reviews

Yahoo! Local

  • author (review author)
  • publication date
  • title
  • description
  • rating
    • overall and by category [1-5]
  • positive summary
  • negative summary


  • usage datetime
  • specific use



SF Survey


  • rating by category
  • cost
  • description

delicious 3rd party

  • rating (0-100%)
  • tags (keywords, year, user-specified others)
  • artist/author (work author)
  • title
  • URL
  • comments
  • unique identifier

iTunes XML

  • rating (0-100%)

review world

Dinner Buzz

Previous Schemas and Formats

Generic to any kind of review


  • variants for embedding in Atom, RSS2, RSS1, RDF
  • apparent schema
    • author of review
    • content of review
    • creator of work
      • example: book author, movie director
    • percentage score rating
    • multiple identifiers
      • example: ISBN, ASIN, UPC, LOC
    • link to purchase
  • appears to be loosely connected with the term "!OpenReviews" (has also referred to other efforts) which itself appears to be yet another OpenBlahBlah buzzword with no substance behind it (AKA placeholder term).

RDF Review Vocabulary

Simple-Review XML

  • Embeds XML in <script type="application/x-subnode">
  • XSD
  • apparent schema
    • review-title
    • item
      • name/title
      • type
      • URL
      • image URL
    • rating (user visible, max, normalized to 0..1 value)
    • comments/description

For specific domains



Thoughts on a Microformat

Thoughts towards a simple MicroFormat subset of earlier efforts, sufficient to express 80/20.

Common review fields

  • item
    • optional:type of item (business, Web page/site, product, event, person, place, file, text)
    • name/title of item being reviewed (string | ["hCard"] if business or person)
      • optional:URL (all additional information should be somewhere else, not in the review itself)
      • optional:image (URL)
  • reviewer (["hCard"]|name|email|URL)
  • review publication/authoring date (ISO8601 datetime)
  • rating 1 to 5 (default max = 5, default min = 1)
  • optional:tags (keyword,rating)*
  • optional:comments (string)

See hReview for the result and evolution of these thoughts on a microformat.