diff --git a/Gemfile.lock b/Gemfile.lock
index 37866348..ab905ab6 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -1,9 +1,10 @@
 GIT
   remote: https://github.com/ruby-rdf/json-ld.git
-  revision: 74095b73cdb722b681f34d0f165599c9cb48d844
+  revision: 172e0c960c9771fa9f963eca55d28fb63bce56b0
   branch: develop
   specs:
     json-ld (3.0.2)
+      htmlentities (~> 4.3)
       json-canonicalization (~> 0.1)
       link_header (~> 0.0, >= 0.0.8)
       multi_json (~> 1.13)
@@ -36,7 +37,7 @@ GEM
     i18n (1.6.0)
       concurrent-ruby (~> 1.0)
     json-canonicalization (0.1.0)
-    json-ld-preloaded (3.0.2)
+    json-ld-preloaded (3.0.3)
       json-ld (~> 3.0)
       multi_json (~> 1.12)
       rdf (~> 3.0)
@@ -74,7 +75,7 @@ GEM
       sparql-client (~> 3.0)
     mini_portile2 (2.4.0)
     multi_json (1.13.1)
-    net-http-persistent (3.0.1)
+    net-http-persistent (3.1.0)
       connection_pool (~> 2.2)
     nokogiri (1.10.3)
       mini_portile2 (~> 2.4.0)
@@ -82,7 +83,7 @@ GEM
       nokogiri
     public_suffix (3.1.1)
     rack (2.0.7)
-    rake (12.3.2)
+    rake (12.3.3)
     rdf (3.0.12)
       hamster (~> 3.0)
       link_header (~> 0.0, >= 0.0.8)
@@ -134,7 +135,7 @@ GEM
     rdf-turtle (3.0.6)
       ebnf (~> 1.1)
       rdf (~> 3.0)
-    rdf-vocab (3.0.7)
+    rdf-vocab (3.0.8)
       rdf (~> 3.0, >= 3.0.11)
     rdf-xsd (3.0.1)
       rdf (~> 3.0)
diff --git a/common/jsonld.js b/common/jsonld.js
index bf3f8c62..27ca57ce 100644
--- a/common/jsonld.js
+++ b/common/jsonld.js
@@ -40,6 +40,19 @@ const jsonld = {
       status: 'unofficial',
       date: 'January 2014'
     },
+    "JSON.API": {
+      title: "JSON API",
+      href: "https://jsonapi.org/format/",
+      authors: [
+        'Steve Klabnik',
+        'Yehuda Katz',
+        'Dan Gebhardt',
+        'Tyler Kellen',
+        'Ethan Resnick'
+      ],
+      status: 'unofficial',
+      date: '29 May 2015'
+    },
     "JCS": {
       title: "JSON Canonicalization Scheme (JCS)",
       href: 'https://tools.ietf.org/html/draft-rundgren-json-canonicalization-scheme-05',
diff --git a/common/terms.html b/common/terms.html
index 6a7668bc..15a1ed8c 100644
--- a/common/terms.html
+++ b/common/terms.html
@@ -225,6 +225,9 @@
     A <a>named graph</a> created from the value of a <a>map entry</a>
     having an <a>expanded term definition</a>
     where <code>@container</code> is set to  <code>@graph</code>.</dd>
+  <dt class="changed"><dfn data-cite="JSON-LD11#dfn-included-block">included block</dfn></dt><dd class="changed">
+    An <a>included block</a> is an <a>entry</a> in a <a>node object</a> where the key is either `@included` or an alias of `@included`
+    and the value is one ore more <a>node objects</a>.</dd>
   <dt><dfn data-cite="JSON-LD11#dfn-index-map">index map</dfn></dt><dd>
     An <a>index map</a> is a <a>map</a> value of a <a>term</a>
     defined with <code>@container</code> set to <code>@index</code>,
@@ -349,4 +352,4 @@
     The vocabulary mapping is set in the <a>context</a> using the <code>@vocab</code> key
     whose value MUST be an <a>IRI</a> or <code>null</code>.</dd>
 </dl>
-</section>
\ No newline at end of file
+</section>
diff --git a/index.html b/index.html
index b88a18d6..6fb645e1 100644
--- a/index.html
+++ b/index.html
@@ -608,6 +608,10 @@ <h2>Syntax Tokens and Keywords</h2>
         Used in a <a>context definition</a> to load an external context
         within which the containing <a>context definition</a> is merged.
         This can be useful to add JSON-LD 1.1 features to JSON-LD 1.0 contexts.</dd>
+      <dt class="changed">`@included`</dt><dd class="changed">
+        Used in a top-level <a>node object</a> to define an <a>included block</a>,
+        for including secondary <a>node objects</a> within another <a>node object</a>.
+      </dd>
     </dl>
 
     <p>All keys, <a>keywords</a>, and values in JSON-LD are case-sensitive.</p>
@@ -8272,6 +8276,262 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
 </section>
 </section>
 
+<section class="informative changed"><h3>Included Nodes</h3>
+  <p>Sometimes it is also useful to list node objects as part of another node object.
+    For instance, to represent a set of resources which are used by some other
+    resource. <a>Included blocks</a> may be also be used to collect such secondary <a>node objects</a>
+    which can be referenced from a primary <a>node object</a>.
+    For an example, consider a node object containing a list of different items,
+    some of which share some common elements:</p>
+
+  <pre class="example input"
+       id="included-blocks-to-be-flattened"
+       title="Included Blocks"
+       data-transform="updateExample">
+  <!--
+  {
+    "@context": {
+      "@version": 1.1,
+      "@vocab": "http://example.org/",
+      "classification": {"@type": "@vocab"},
+      "service": {"@type": "@vocab"}
+    },
+    "@id": "http://example.org/base/1",
+    "@type": "Thing-with-Items",
+    "items": [{
+      "@id":"http://example.org/base/2",
+      "classification": "enum#c6",
+      "service": "enum#s2"
+    }, {
+      "@id": "http://example.org/base/3",
+      "classification": "enum#c6"
+    }],
+    ****"@included": [{
+      "@id": "http://example.org/enum#c6",
+      "@type": "Type",
+      "label": "Classification 6"
+    }, {
+      "@id": "http://example.org/enum#s2",
+      "@type": "Service",
+      "label": "Login Service"
+    }]****
+  }
+  -->
+  </pre>
+
+  <p>When <a>flattened</a>, this will move the `enum:c6` and `enum:s2` elements
+    from the <a>included block</a> into the outer <a>array</a>.</p>
+
+  <aside class="example ds-selector-tabs"
+         title="Flattened form for included blocks">
+    <div class="selectors">
+      <button class="selected" data-selects="flattened">Flattened (Result)</button>
+      <button data-selects="statements">Statements</button>
+      <button data-selects="turtle">Turtle</button>
+      <a class="playground" target="_blank"
+         data-result-for="#included-blocks-to-be-flattened"></a>
+    </div>
+    <pre class="flattened result selected" data-transform="updateExample"
+         data-flatten
+         data-result-for="Included Blocks">
+    <!--
+    [{
+      "@id": "http://example.org/base/1",
+      "@type": ["http://example.org/Thing-with-Items"],
+      "http://example.org/items": [
+        {"@id": "http://example.org/base/2"},
+        {"@id": "http://example.org/base/3"}
+      ]
+    }, {
+      "@id": "http://example.org/enum#c6",
+      "@type": ["http://example.org/Type"],
+      "http://example.org/label": [{"@value": "Classification 6"}]
+    }, {
+      "@id": "http://example.org/enum#s2",
+      "@type": ["http://example.org/Service"],
+      "http://example.org/label": [{"@value": "Login Service"}]
+    }, {
+      "@id": "http://example.org/base/2",
+      "http://example.org/classification": [
+        {"@id": "http://example.org/enum#c6"}
+      ],
+      "http://example.org/service": [
+        {"@id": "http://example.org/enum#s2"}
+      ]
+    }, {
+      "@id": "http://example.org/base/3",
+      "http://example.org/classification": [
+        {"@id": "http://example.org/enum#c6"}
+      ]
+    }
+  ]
+    -->
+    </pre>
+    <table class="statements"
+           data-result-for="Flattened form for included blocks-flattened"
+           data-to-rdf>
+      <thead><tr><th>Subject</th><th>Property</th><th>Value</th></tr></thead>
+      <tbody>
+      <tr><td>http://example.org/base/1</td><td>rdf:type</td><td>http://example.org/Thing-with-Items</td></tr>
+      <tr><td>http://example.org/base/1</td><td>http://example.org/items</td><td>http://example.org/base/2</td></tr>
+      <tr><td>http://example.org/base/1</td><td>http://example.org/items</td><td>http://example.org/base/3</td></tr>
+      <tr><td>http://example.org/base/2</td><td>http://example.org/classification</td><td>http://example.org/enum#c6</td></tr>
+      <tr><td>http://example.org/base/2</td><td>http://example.org/service</td><td>http://example.org/enum#s2</td></tr>
+      <tr><td>http://example.org/base/3</td><td>http://example.org/classification</td><td>http://example.org/enum#c6</td></tr>
+      <tr><td>http://example.org/enum#c6</td><td>rdf:type</td><td>http://example.org/Type</td></tr>
+      <tr><td>http://example.org/enum#c6</td><td>http://example.org/label</td><td>Classification 6</td></tr>
+      <tr><td>http://example.org/enum#s2</td><td>rdf:type</td><td>http://example.org/Service</td></tr>
+      <tr><td>http://example.org/enum#s2</td><td>http://example.org/label</td><td>Login Service</td></tr>
+      </tbody>
+    </table>
+    <pre class="turtle"
+         data-content-type="text/turtle"
+         data-result-for="Flattened form for included blocks-flattened"
+         data-transform="updateExample"
+         data-to-rdf>
+    <!--
+    @prefix ex: <http://example.org/> .
+    @prefix enum: <http://example.org/enum#> .
+
+    <http://example.org/base/1> a ex:Thing-with-Items;
+      ex:items <http://example.org/base/2>, <http://example.org/base/3> .
+
+    <http://example.org/base/2> ex:classification enum:c6;
+      ex:service enum:s2 .
+
+    <http://example.org/base/3> ex:classification enum:c6 .
+
+    enum:c6 a ex:Type;
+      ex:label "Classification 6" .
+
+    enum:s2 a ex:Service;
+      ex:label "Login Service" .
+    -->
+    </pre>
+  </aside>
+
+  <p>Included resources are described in
+    <a data-cite="JSON.API#fetching-includes">Inclusion of Related Resources</a> of [[[JSON.API]]] [[JSON.API]]
+    as a way to include related resources associated with some primary resource;
+    `@included` provide an analogous possibility in JSON-LD.</p>
+
+  <p>As a by product of the use of `@included` within <a>node objects</a>, a <a>map</a> may contain
+    only `@included`, to provide a feature similar to that described in <a href="#advanced-context-usage" class="sectionRef"></a>,
+    where `@graph` is used to described disconnected <a>nodes</a>.</p>
+
+  <aside class="example ds-selector-tabs changed"
+         title="Describing disconnected nodes with @included">
+    <div class="selectors">
+      <button class="selected" data-selects="compacted">Compacted (Input)</button>
+      <button data-selects="expanded">Expanded (Result)</button>
+      <button data-selects="flattened">Flattened</button>
+      <button data-selects="statements">Statements</button>
+      <button data-selects="turtle">Turtle</button>
+      <a class="playground" target="_blank"></a>
+    </div>
+    <pre class="compacted input selected nohighlight" data-transform="updateExample">
+    <!--
+    {
+      "@context": {
+        "Person": "http://xmlns.com/foaf/0.1/Person",
+        "name": "http://xmlns.com/foaf/0.1/name",
+        "knows": {"@id": "http://xmlns.com/foaf/0.1/knows", "@type": "@id"}
+      },
+      ****"@included": [{
+        "@id": "http://manu.sporny.org/about#manu",
+        "@type": "Person",
+        "name": "Manu Sporny",
+        "knows": "https://greggkellogg.net/foaf#me"
+      }, {
+        "@id": "https://greggkellogg.net/foaf#me",
+        "@type": "Person",
+        "name": "Gregg Kellogg",
+        "knows": "http://manu.sporny.org/about#manu"
+      }]****
+    }
+    -->
+    </pre>
+    <pre class="expanded result nohighlight"
+         data-transform="updateExample"
+         data-result-for="Describing disconnected nodes with @included-compacted">
+    <!--
+    [{
+      ****"@included": [{
+        "@id": "http://manu.sporny.org/about#manu",
+        "@type": ["http://xmlns.com/foaf/0.1/Person"],
+        "http://xmlns.com/foaf/0.1/name": [{"@value": "Manu Sporny"}],
+        "http://xmlns.com/foaf/0.1/knows": [
+          {"@id": "https://greggkellogg.net/foaf#me"}
+        ]
+      }, {
+        "@id": "https://greggkellogg.net/foaf#me",
+        "@type": ["http://xmlns.com/foaf/0.1/Person"],
+        "http://xmlns.com/foaf/0.1/name": [{"@value": "Gregg Kellogg"}],
+        "http://xmlns.com/foaf/0.1/knows": [
+          {"@id": "http://manu.sporny.org/about#manu"}
+        ]
+      }]****
+    }]
+    -->
+    </pre>
+    <pre class="flattened nohighlight"
+         data-transform="updateExample"
+         data-flatten
+         data-result-for="Describing disconnected nodes with @included-expanded">
+    <!--
+    [{
+      "@id": "http://manu.sporny.org/about#manu",
+      "@type": ["http://xmlns.com/foaf/0.1/Person"],
+      "http://xmlns.com/foaf/0.1/name": [{"@value": "Manu Sporny"}],
+      "http://xmlns.com/foaf/0.1/knows": [
+        {"@id": "https://greggkellogg.net/foaf#me"}
+      ]
+    }, {
+      "@id": "https://greggkellogg.net/foaf#me",
+      "@type": ["http://xmlns.com/foaf/0.1/Person"],
+      "http://xmlns.com/foaf/0.1/name": [{"@value": "Gregg Kellogg"}],
+      "http://xmlns.com/foaf/0.1/knows": [
+        {"@id": "http://manu.sporny.org/about#manu"}
+      ]
+    }]
+    -->
+    </pre>
+    <table class="statements"
+           data-result-for="Describing disconnected nodes with @included-expanded"
+           data-to-rdf>
+      <thead><tr><th>Subject</th><th>Property</th><th>Value</th><th>Value Type</th></tr></thead>
+      <tbody>
+        <tr><td>http://manu.sporny.org/about#manu</td><td>rdf:type</td><td>foaf:Person</td><td>&nbsp;</td></tr>
+        <tr><td>http://manu.sporny.org/about#manu</td><td>foaf:name</td><td>Manu Sporny</td><td>&nbsp;</td></tr>
+        <tr><td>http://manu.sporny.org/about#manu</td><td>foaf:knows</td><td>https://greggkellogg.net/foaf#me</td><td>&nbsp;</td></tr>
+        <tr><td>https://greggkellogg.net/foaf#me</td><td>rdf:type</td><td>foaf:Person</td><td>&nbsp;</td></tr>
+        <tr><td>https://greggkellogg.net/foaf#me</td><td>foaf:name</td><td>Gregg Kellogg</td><td>&nbsp;</td></tr>
+        <tr><td>https://greggkellogg.net/foaf#me</td><td>foaf:knows</td><td>http://manu.sporny.org/about#manu</td><td>&nbsp;</td></tr>
+      </tbody>
+    </table>
+    <pre class="turtle nohighlight"
+         data-content-type="text/turtle"
+         data-result-for="Describing disconnected nodes with @included-expanded"
+         data-transform="updateExample"
+         data-to-rdf>
+    <!--
+    @prefix foaf: <http://xmlns.com/foaf/0.1/> .
+
+    <http://manu.sporny.org/about#manu> a foaf:Person;
+      foaf:name "Manu Sporny";
+      foaf:knows <https://greggkellogg.net/foaf#me> .
+
+    <https://greggkellogg.net/foaf#me> a foaf:Person;
+      foaf:name "Gregg Kellogg";
+      foaf:knows <http://manu.sporny.org/about#manu> .
+    -->
+    </pre>
+  </aside>
+
+  <p>However, in contrast to `@graph`, `@included` does not interact with other <a>properties</a>
+    contained within the same <a>map</a>, a feature discussed further in <a href="#named-graphs" class="sectionRef"></a>.</p>
+</section>
+
 <section class="informative"><h2>Reverse Properties</h2>
 
   <p>JSON-LD serializes directed <a>graphs</a>. That means that
@@ -8474,7 +8734,6 @@ <h3>Using the Document Base for the Default Vocabulary</h3>
     <a>expanded term definitions</a>
     to create reverse properties as shown in the following example:</p>
 
-
   <aside class="example ds-selector-tabs"
          title="Using @reverse to define reverse properties">
     <div class="selectors">
@@ -11535,6 +11794,7 @@ <h2>Node Objects</h2>
     <ul>
       <li><code>@context</code>,</li>
       <li><code>@id</code>,</li>
+      <li class="changed">`@included`,</li>
       <li><code>@graph</code>,</li>
       <li class="changed"><code>@nest</code>,</li>
       <li><code>@type</code>,</li>
@@ -11587,6 +11847,11 @@ <h2>Node Objects</h2>
       a <a>relative IRI</a>, a <a>compact IRI</a>, a <a>blank node identifier</a>,
       a <a>node object</a> or an <a>array</a> containing a combination of these.</p>
 
+    <p class="changed">If the <a>node object</a> contains the `@included` key,
+      its value MUST be an <a>included block</a>.
+      See <a class="sectionRef" href="#included-blocks"></a> for further discussion
+      on <a>included blocks</a>.</p>
+
     <p>If the <a>node object</a> contains the <code>@index</code> key,
       its value MUST be a <a>string</a>. See
       <a class="sectionRef" href="#data-indexing"></a> for further discussion
@@ -11617,6 +11882,7 @@ <h2>Node Objects</h2>
       <li>an <a>array</a> of zero or more of any of the possibilities above,</li>
       <li>a <a>language map</a>,</li>
       <li>an <a>index map</a>,</li>
+      <li class="changed">an <a>included block</a></li>
       <li class="changed">an <a>id map</a>, or</li>
       <li class="changed">a <a>type map</a></li>
     </ul>
@@ -11918,6 +12184,16 @@ <h2>Type Maps</h2>
       added as a <code>@type</code> of the <a>node object</a> value when expanding.</p>
   </section>
 
+  <section class="changed">
+    <h2>Included Blocks</h2>
+
+    <p>An <a>included block</a> is used to provide a set of <a>node objects</a>.
+      An <a>included block</a> MAY appear as the value of a member of a node object with either the key of `@included` or an alias of `@included`.
+      An <a>included block</a> is either a <a>node object</a> or an array of <a>node objects</a>.</p>
+
+    <p>When <a data-lt="expansion">expanding</a>, multiple <a>included blocks</a> will be coalesced into a single <a>included block</a>.</p>
+  </section>
+
   <section class="changed">
     <h2>Property Nesting</h2>
 
@@ -12246,6 +12522,12 @@ <h2>Keywords</h2>
       This keyword is described further in <a class="sectionRef" href="#context-definitions"></a>,
       and <a class="sectionRef" href="#default-vocabulary"></a>.
     </dd>
+    <dt>`@included`</dt><dd>
+      The `@included` keyword MAY be aliased and
+      its value MUST be an <a>included block</a>.
+      This keyword is described further in <a class="sectionRef" href="#included-nodes"></a>,
+      and <a class="sectionRef" href="#included-blocks"></a>.
+    </dd>
   </dl>
 </section>
 </section>
@@ -13171,6 +13453,13 @@ <h2>Changes since JSON-LD Community Group Final Report</h2>
     <li>A context may contain an <code>@import</code> <a>entry</a> used to reference a remote context
       within a context, allowing <code>JSON-LD 1.1</code> features to be added to contexts originally
       authored for <code>JSON-LD 1.0</code>.</li>
+    <li>A <a>node object</a> may include an <a>included block</a>,
+      which is used to contain a set of <a>node objects</a> which are treated
+      exactly as if they were <a>node objects</a> defined in an <a>array</a> including the containing
+      <a>node object</a>.
+      This allows the use of the object form of a JSON-LD document when there is more
+      than one <a>node object</a> being defined, and where those <a>node objects</a>
+      are not embedded as values of the containing <a>node object</a>.</li>
   </ul>
 </section>