Thursday, February 5, 2015 v1.93: VisualArtwork, Invoices, plus lots of fixes and improvements.

Version v1.93 of has just been released.  As we mentioned in the previous update we are working towards a stable "version 2" release. This isn't yet v2.0, but it serves as a foundation,
fixing a variety of small issues across many schemas and examples. 

This release also introduces new vocabulary for describing visual artworks: a new VisualArtwork type alongside supporting properties - artEdition, artformmaterial and surface. Many thanks to Paul Watson for leading that work. See also Paul's blog posts about the schema, its mapping to the VRA Core 4, and its use with Getty's Art and Architecture Thesaurus (AAT) via Linked Data.

Invoices and bills also now have dedicated vocabulary in, see the new Invoice type for details. This addresses situations when an invoice is received that is not directly attached to an Order, for example utility bills.

As usual then release notes page has full details. In recent weeks we have been taking care to document the status of all open issues and proposals in our issue tracker on the Github site. As always, thanks are due to everyone who contributed to this release and to the ongoing discussions in Github and at W3C. 

Thursday, December 11, 2014 v1.92: Music, Video Games, Sports, Itemlist, breadcrumbs and more!

We are happy to announce version v1.92 of With this update we "soft launch" a substantial collection of improvements that will form the basis for a version 2.0 release in early 2015. There remain a number of site-wide improvements, bugfixes and clarifications that we'd like to make before we feel ready to use the name "v2.0". However the core vocabulary improvements are stable and available for use from today. As usual see the release notes page for details.

Please get in touch via the W3C Web Schemas group or our Github issue tracker if you'd like to share feedback with us and the wider community. We won't go into the details of each update in today's blog post, but there are a lot of additions and fixes, and more coming in 2015. Many thanks to all those who contributed to this release!

Friday, September 12, 2014 v1.91: Offer/price documentation fixes, cleanup and community contributions. has been updated to v1.91.

From the release notes:

  • Updated text of the price property to include practical usage guidance, alongside links to information from GS1 for the gtin-related Offer properties.
  • Updated all our examples to follow that guidance; primarily by using priceCurrency and the content= attribute.
  • Noted our thanks to the OpenDomain project for our domain name.
  • Updated the text of the 'image' property to match its expected types. Thanks, Dan Scott!
  • Changed spelling of 'supercededBy' to the more conventional supersededBy. Thanks, Sachini Aparna Herath!
  • Noted that 'logo' and 'photo' are sub-properties of 'image'. Thanks, Sachini Aparna Herath, again!
  • Fixed two syntax errors in examples (Store opening hours RDFa; Book, PublicationVolume Microdata). Thanks, Gregg Kellogg!
  • Added Tolkien-based examples for exampleOfWork/workExample. Thanks, Dan Scott, again!
  • Fixed a bug with our UTF-8 support. Thanks, Richard Wallis!
See the releases page in our documentation for details of previous updates.

Tuesday, September 2, 2014 Support for Bibliographic Relationships and Periodicals

[Guest post by Richard Wallis, OCLC & Dan Scott, Laurentian University]
With the addition of three new types, the latest version of introduces support for describing the relationship between, Articles and the Periodicals in which they were published, along with potentially related PublicationIssues & PublicationVolumes. For example:
  • The article "The semantic web" was published in May 2001, in volume 284, issue 5 of Scientific american on pages 28 through 37.
  • That issue of Scientific American contained 33 other articles listed at
  • The editors for that issue included Mark Alpert, Steve Ashley, and Carol Ezzell.
You can now also describe creative works that span multiple parts using the hasPart and isPartOf properties, and you can express relationships between a conceptual representation of a creative work and physical examples of that work using the exampleOfWork and workExample properties. For example:
  • The Lord of the Rings is a trilogy consisting of three separate books.
  • One edition of the first book, The Fellowship of the Ring, was published by HarperCollins in 1974 with ISBN .
  • Another edition of the first book was published by Ballantine Books in 1984 with ISBN 0345296052.
  • The movie J.R.R. Tolkien's The Lord of the Rings, directed by Ralph Bakshi and released in 1978, was based on the first book in the trilogy.
  • The movie The Lord of the Rings: The Fellowship of the Ring, directed by Peter Jackson and released in 2001, was also based on the first book in the trilogy.
These extensions were developed by the W3C Schema Bib Extend Community Group, and were designed in the spirit of to provide an easily published and widely consumable vocabulary for creative works. Many other modelling and vocabulary initiatives, such as RDA and BIBFRAME, continue to work towards offering the additional layers of granularity of description desired by many in the bibliographic metadata world, and these extensions hope to complement those efforts. Where possible, we aligned our work with the Bibliographic Ontology, and acknowledge their leadership in tackling many of these issues.

We are pleased with the outcome of working with the broader W3C Web Schemas Task Force community to refine these extensions, which also helped address similar concepts and relationships required by a number of associated domains such as TV, Radio and Music Recording. One outcome of this discussion was the elevation of position to a general superproperty of properties such as issueNumber, volumeNumber, seasonNumber, and episodeNumber. Combined with the recent addition of the Role type, now has the flexible, generic framework to address the specialized needs of other domains such as Comics.

We welcome the acceptance, refinement and introduction of these proposals by, which greatly enhances the capability for describing creative works in general, and bibliographic resources in particular.

Monday, June 16, 2014

Introducing 'Role'

To date, has supported relatively simple relations between entities.  For example, if we wanted to describe Joe Montana as an athlete on the San Francisco 49ers team, we might represent this using the newly proposed "athlete" property of a SportsTeam. 

This is a pretty clear structure, but it doesn't offer anywhere to attach further information about the relationship.  Building on our example, let's say we wanted to also indicate that Joe Montana only played for the San Francisco 49ers from 1979 to 1992 and that his position was "Quarterback".

To accomplish this, we introduce a new type called Role.  The new Role type serves to elaborate or qualify these more simple relationships. We have been motivated by concrete problems around organizational affiliations such as those occurring in music and sports. In both cases it is important to specify time periods in a sporting or musical career.

To specify the role being played, the Role entity reuses the initial property from, and then extends the semantics of the relationship by way of additional properties like "startDate".

In essence, we are replacing the "athlete" property's original value (a Person node) with an intermediary node (Role). The original node is moved one hop away and becomes the value of the re-used "athlete" property. After considering several designs, we chose this approach as the simplest.

The Role schema allows algorithms to collapse down to the simple graph from a more complicated Role-based description. In the example above, we can assume Joe Montana is a valid value for the "athlete" property on the 49ers SportsTeam. More formally, if some Role R has incoming property P from entity A, and A also has an outgoing occurrence of property P to entity B, we can assume it is reasonable to describe A as having a 'P' property whose value is B.

These details are more important to consumers of than publishers, as they allow for backwards compatibility, while also permitting any property to be used with roles.

The Role type (much like URL) can be used with any types. We will not clutter the site with statements emphasizing this, except in cases (e.g. around sports and music) where the Role mechanism is particularly useful. We have added examples of Role usage in Microdata, RDFa and JSON-LD notation to the site, and look forward to seeing more detailed descriptions using this mechanism.

As we continue to evolve the site we expect to add more properties and sub-types that have been designed to work with the Role type. For now, we introduce two kinds of Role: OrganizationRole and PerformanceRole. In the sporting example shown above, the Role node (the red circle) would be an OrganizationRole and in addition to defining the "startDate" and "endDate" for that role, we might also define indicate Joe Montana was a quarterback by using the "namesPosition" property. Similarly, the PerformanceRole type provides a characterName property that might be used to describe Bill Murray's role in Ghostbusters. The Role pattern works here too. See the site for full RDFa, Microdata and JSON-LD markup, including the Ghostbusters example shown here:

Vicki Tardif Holland (Google)
Jason Johnson (Microsoft)

Friday, May 16, 2014 v1.4 update: examples, examples, examples...

We've just posted an update to the site, focussing on improved examples. Our last update introduced a new property called workPerformed which relates an Event to a CreativeWork performed at the event. Today's improvements add examples of this property to MusicEvent and TheaterEvent.

There are also new JSON-LD examples for MusicEvent, alongside additions showing RDFa, Microdata and JSON-LD examples for various local business-related types including Restaurant, StorePharmacy, Corporation, PostalAddress,  Organization, ContactPoint and OpeningHoursSpecification. This update also includes improvements to the navigation for MedicalEnumeration types, alongside fixes for several other typos and glitches - both of which are thanks to Dan Scott.

Finally, it's worth highlighting the recent addition of substantial vocabulary for describing Reservations, as well as a type for describing an EmailMessage. These complement the Actions design announced last month.

Wednesday, April 16, 2014

Announcing Actions

When we launched almost 3 years ago, our main focus was on providing vocabularies for describing entities --- people, places, movies, restaurants, ... But the Web is not just about static descriptions of entities. It is about taking action on these entities --- from making a reservation to watching a movie to commenting on a post.

Today, we are excited to start the next chapter of and structured data on the Web by introducing vocabulary that enables websites to describe the actions they enable and how these actions can be invoked.

The new actions vocabulary is the result of over two years of intense collaboration and debate amongst the partners and the larger Web community. Many thanks to all those who participated in these discussions, in particular to members of the Web Schemas and Hydra groups at W3C. We are hopeful that these additions to will help unleash new categories of applications.

Jason Douglas,
Sam Goto (Google)

Steve Macbeth, 
Jason Johnson (Microsoft)

Alexander Shubin (Yandex)

Peter Mika (Yahoo)

To learn more, see the overview document or Action, potentialAction and EntryPoint on

Thursday, February 6, 2014 Sports Vocabulary

The partners, in collaboration with experts from the BBC and IPTC/SportsML, are pleased to share a proposal for improving the sports vocabulary.  The proposal includes support for describing sports organizations, athletes, and events, with a focus on the most common sports types being published on the Web today. Although the proposal includes support for describing sports statistics within these domains, the initial set of properties are limited to those which are broadly applicable.  More detailed, sport-specific statistics will be the subject of future additions to the base statistic classes.

The sports vocabulary proposal is available as an exported PDF in the W3C Web Schemas - Sports wiki and a machine readable version of the schema will be posted soon.  We encourage the web community to review and provide feedback via the wiki, the W3C public vocabs mailing list (, or by joining the sports vocabulary discussion group.

Thursday, December 5, 2013

Content Accessibility

It has long been important to help users find the "right content". With the incredible diversity of the people who use the Web, and the devices they are using it from, it is more important than ever to find the content that works best for a given user's current situation.

Content metadata has an important role to play in this regard. So we're very happy to announce the inclusion of several Accessibility properties into, published this week. These additions to CreativeWork make it easier for publishers and webmasters to connect end-users with the most useful content, and help users with special needs locate and consume content that is most appropriate for their specific needs. For example a blind user may want to locate a text-book that is available with particular accessibility features and formats, or a user with hearing impairments may need to locate a captioned version of a video.

This work draws upon many collaborations and projects including the IMS Global Learning Consortium's Access For All specification (, the work of the Accessibility Metadata Project (, alongside many discussions that helped ensure the work integrated well into

Many thanks to everyone who has contributed!

TV Raman (Google)
Chaals (Yandex)