The GoodRelations User's Guide

Work in progress: The new GoodRelations User's Guide is still under development, so many pages shown below are currently just placeholders with little content. In the meantime, you can use the 2008 version of the GoodRelations primer, available at

I. Quickstart (to be completed)

  1. What is GoodRelations?
  2. Whetting Your Appetite: Adding GoodRelations to a Web Site for Google and other Search Engines
  3. Adding GoodRelations to Standard Web Shop Software
  4. Feature Comparison

II. Preliminaries (to be completed)

  1. Design Goals and Considerations
  2. GoodRelations vs. the Semantic Web, Linked Data, and the Opengraph Protocol
  3. RDF, RDF/XML, RDFa, Microdata, and SPARQL
  4. Understanding the New Role of URIs for Data Markup
  5. The Single, Most Productive Way of Developing RDFa Markup
  6. GoodRelations in Microdata Syntax and in Combination with
  7. Tool Recommendations for Developers

III. GoodRelations in Depth (to be completed)

  1. Understanding the Conceptual Model
  2. Representing Quantitative Values (Examples: 220 volts, 5 to 10 miles, 5400 rpm)
  3. Representing Qualitative Values and Enumerations (Examples: Garment sizes, product colors, plug types)
  4. Offer (gr:Offering)
  5. Company or Person (gr:BusinessEntity)
  6. Store or Point of Sale (gr:Location)
  7. Opening Hours
  8. Product or Service (gr:ProductOrService, gr:SomeItems, gr:Individual)
  9. Product Features
  10. Pricing
  11. Bundles
  12. Options, Add-ons, Extensions
  13. Product Models
  14. Product Variants
  15. Structured Values and Value References
  16. Consumables, Accessories, Spare Parts, and Similar Products
  17. GoodRelations and Product Ontologies
  18. Developing Extensions for Vertical Industries
  19. Explicating Demand: Wish-lists, Tendering, Interest to Buy
  20. Exposing Ownership: Global Shopping History
  21. Reviews
  22. Images and Logos
  23. Geo Data

IV. Publishing GoodRelations Data (to be completed)

  1. Overview
  2. RDFa and Microdata
  3. Linked Data
  4. SPARQL Endpoints
  5. Combined Multiple Formats
  6. Sitemaps, Semantic Sitemaps, and Dumps
  7. Spreading the Word: Ping Services and Search Engine Submission
  8. Access Control

V. Consuming GoodRelations Data (to be completed)

  1. Overview
  2. Finding Offers
  3. Finding Product Model Master Data
  4. Finding Stores
  5. Matchmaking

VI. Annex (to be completed)

  1. Popular UN/CEFACT Common Codes for Units of Measurement