Branch: master
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
83 lines (64 sloc) 3.26 KB

Approaches to implementing JSON-LD microdata


The basic approach to including JSON-LD based HTML5 microdata in a web page is to simply include a <script type="application/ld+json"> tag in the body of the page. Normally this is done within the <head> tag of the page but in practice can be anywhere in the document.

For a live example you can visit the Open Core Data page and do a "view source" on the page. The contents of the <script type="application/ld+json"> is JSON-LD. Examples of JSON-LD can be seen in this repository in the form of the files:

and others.

These are JSON-LD files that would be scoped by the script tag. Feel free to raise any questions about these in the issues section of this repository.

Simple example with testing option

A complete, though simple, example of this process is fully scoped below to demonstrate the approach.
This text can be pasted into the Google testing tool to validate. Note, it will error on the URL only due to the fact this is not a valid URL and the content is not coming directly from that domain. For more detailed examples of JSON-LD look at the examples in this repository.

<!doctype html>
<html lang="en">
    <title>Example Org</title>
    <script type="application/ld+json">
            "@context": "",
            "@type": "Organization",
            "name": "Example Org",
            "contactPoint": {
                "@type": "ContactPoint",
                "name": "John Doe",
                "email": "",
                "url": "",
                "contactType": "technical support"
            "url": "",
            "potentialAction": [{
                "@type": "SearchAction",
                "target": {
                    "@type": "EntryPoint",
                    "urlTemplate": "",
                    "description": "Swagger 1.2 description document",
                    "httpMethod": "GET"

  My great facility data

For more information on JSON-LD as well as tools and examples visit the JSON-LD Playground.

Some early tests / linting

The following links show results of tests on the BCO-DMO JSON-LD file. Note that the URL error at the Google tool is related to hosting the file at a domain different than what it referees to.

Results from Google Structure Data Testing Tool

View results

Structured Data Linter

View results