JSON-LD Explained for Personal Websites

A developer’s cheerful guide to adding JSON-LD — basically extra hidden labels that help Google and other crawlers understand a site — should have been a sleepy how-to for personal website nerds. Instead, the comments turned into a mini revolt. Yes, the article itself is practical: add a special block of text in your page’s code, describe your site clearly, and you might earn richer search results, better previews, and maybe even a search boost. But the crowd immediately zoomed past the tutorial and into the existential crisis of modern web-building: why do we have to describe the same thing twice?

That was the big mood. One commenter groaned that the web already has semantic HTML — in plain English, built-in ways to describe what a page means — so why are people now stuffing “bespoke weird JSON in a script tag that the browser won’t process”? Ouch. Another called it “a bit disappointing” that site owners may have to duplicate information in both visible page code and this hidden format, even though older methods already existed. In other words: the web had one job, and it somehow created homework.

Not everyone was throwing tomatoes. One reader called the piece super useful, especially for people doing search engine optimization, and another urged pragmatists to check Google’s own documentation, a subtle way of saying: nice guide, but the real boss is Google. The spiciest take, though, came from a commenter who basically said this whole game may already be outdated, because search results are now crowded with AI-generated summaries that can mangle the original source. So the drama isn’t just “how do I label my website?” — it’s whether the labels still matter when the internet’s new middleman is an error-prone robot.