JSON-LD To Framed
Frame JSON-LD documents using a JSON-LD frame to extract specific subgraphs with real-time browser-side processing.
Extract subgraphs from JSON-LD with framing
JSON-LD framing lets you select a specific view of a linked data graph. A frame describes the shape of data you want to extract, including which properties to include, how to embed related nodes, and which types to match.
What this tool does
Provide a JSON-LD document and a JSON-LD frame. The converter applies the W3C JSON-LD framing algorithm and returns a new document shaped according to your frame specification.
When to use framing
- Extract a specific entity and its related objects from a large graph.
- Build API responses that match a predefined data shape.
- Filter schema.org graphs to return only relevant entity types.
- Embed nested resources inline using frame embed directives.
Related tools
For the opposite transformation, use JSON-LD to Expanded to expand compact documents. To merge all nodes into one, try JSON-LD to Flattened.
Frequently Asked Questions
What is a JSON-LD frame?
A frame is a JSON-LD document that describes the desired output structure. It specifies which properties to include, which node types to match, and how to embed or exclude related nodes.
What does embed mean in a frame?
The @embed frame keyword controls whether related nodes are inlined in the output. Values like @always force embedding, while @never keeps only references. Put @embed on frame properties, not inside @context term definitions.
Does processing happen in the browser?
Yes. This tool uses the jsonld.js processor locally. Your documents are not uploaded to a server.
Can I frame a document with @graph?
Yes. Framing works on documents containing @graph arrays. The frame selects matching nodes from the graph and shapes the output according to your frame definition.
What if framing fails?
Common causes include invalid JSON syntax, a frame that does not match any nodes in the input graph, or incompatible @context definitions. Check the error message for details.