JSON-LD Explained for Personal Websites
Original: JSON-LD Explained for Personal Websites
Why This Matters
Structured data implementation affects search visibility and crawler understanding of website content across the SEO industry.
JSON-LD is a structured data format that helps web crawlers understand webpage content, enabling richer search previews and potentially improving search rankings. Developer Ethan Hawksley explains implementation fundamentals and best practices for personal sites.
JSON-LD (JSON Linked Data) is a format for embedding structured data into webpages that aids search engine crawlers and other automated tools in understanding semantic content. According to Hawksley's guide, JSON-LD is added within a <script type="application/ld+json"> tag in the page's head section. The format uses a context property pointing to schema.org, which defines valid key-value pairs for structured data. JSON-LD documents function as labeled, directed graphs containing nodes with three components: @type (describing the node category), @id (unique identifier, typically a URL with hash), and properties (key-value pairs describing attributes). Hawksley notes that web crawlers can merge node properties across multiple pages when they share the same ID, though single-page readers like LLMs cannot. The guide recommends using URL-based IDs with hash suffixes (e.g., #website) for uniqueness. Best practice involves balancing reusable JSON-LD across pages while maintaining clarity for single-page scrapers. Hawksley implemented JSON-LD on each page of his personal website after spending approximately 100 hours coding over four months. The article focuses on node types with measurable SEO impact, including WebSite nodes containing properties like url, name, alternateName, and description.