Frequently Asked Questions

Question 1

What is JSON-LD structured data?

Accepted Answer

JSON-LD (JavaScript Object Notation for Linked Data) is a W3C standard for embedding structured data in web pages. It uses a <script type="application/ld+json"> tag to describe entities like organizations, products, articles, and events using the schema.org vocabulary. Search engines use this data to generate rich results, knowledge panels, and enhanced search listings.

Question 2

How does the schema visualizer work?

Accepted Answer

Paste your JSON-LD markup into the editor and the tool automatically parses it, extracts all entities and their relationships, then renders an interactive node-edge graph. Each node represents a schema.org entity (Organization, Person, Product, etc.) and edges show how entities relate to each other through properties like 'founder', 'publisher', or 'author'. Click any node to inspect its properties.

Question 3

What is a @graph in JSON-LD?

Accepted Answer

A @graph array lets you define multiple related entities in a single JSON-LD block. Instead of using separate <script> tags for each entity, you wrap them in a @graph array within one block. This is particularly useful for connecting entities via @id references — for example, linking an Organization to its founder Person and its WebSite.

Question 4

What is the @id property and why is it important?

Accepted Answer

The @id property is a unique identifier for a JSON-LD entity, typically a URL or URL fragment (e.g., 'https://example.com/#organization'). It enables cross-referencing between entities — when one entity references another's @id, it creates a semantic link. This is critical for building a connected knowledge graph that search engines and AI systems can traverse.

Question 5

Which schema.org types should I use for my website?

Accepted Answer

The most impactful types depend on your site: LocalBusiness for physical businesses (enables local pack results), Product for e-commerce (price and availability rich results), Article/BlogPosting for content sites (article rich results), FAQPage for FAQ sections (expandable FAQ snippets), and Organization for any business (knowledge panel data). Use the 'Load sample' button to see a multi-entity example.

Question 6

How do I validate my JSON-LD markup?

Accepted Answer

This tool provides real-time validation as you type, checking for valid JSON syntax, proper @context and @type declarations, and structural correctness. For production validation, also test with Google's Rich Results Test (search.google.com/test/rich-results) to confirm which rich result types your markup qualifies for and catch any Google-specific requirements.

Schema Visualizer

Frequently Asked Questions