The GoodRelations User's Guide

Note: The new GoodRelations User's Guide is still under development.

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. Adding GoodRelations to Your Site
  3. Minimal Example for Google and Yahoo and Facebook
  4. Adding GoodRelations to Standard Web Shop Software
  5. 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 schema.org
  7. Tool Recommendations for Developers

III. GoodRelations in Depth (to be completed)

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

IV. Publishing GoodRelations Data (to be completed)

  1. Overview
  2. Only RDFa
  3. Only Microdata
  4. Only RDF/XML
  5. SPARQL Endpoints
  6. Combining RDFa and RDF/XML
  7. Sitemaps, Semantic Sitemaps, and Dumps
  8. Spreading the Word: Ping Services and Search Engine Submission

V. Consuming GoodRelations Data (to be completed)

  1. Overview
  2. Offers
  3. Model master data
  4. Stores
  5. Matchmaking

VI. Annex (to be completed)

  1. Popular UN/CEFACT Common Codes for Units of Measurement
Retrieved from "http://wiki.goodrelations-vocabulary.org/Documentation"