The entity graph on every article

Every article ships an @graph naming the article, its breadcrumbs, the organisation behind it, the website and the person who wrote it — with stable ids so ten pages resolve to one publisher.

What it is

A single JSON-LD graph on each post carrying five linked nodes: Organization (with logo, description, areas served and a knowsAbout list), WebSite, Person (the author, linked to the organisation), BreadcrumbList, and Article with word count, publication and modification dates, an explicit audience of post-frame and pole barn builders, and a speakable specification naming the H2s and paragraphs an answer surface may read aloud.

Also called: schema markup · structured data · rich results · JSON-LD

See it
The entity graph on every article
CustomerBuildingAmountStatus
Marlin HooverHobby Shop$2,530Paid
Ivy Brubaker40×64 Shop$2,340Open
Gideon AltRiding Arena$12,410Draft
Marlin HooverEquipment Storage$10,130Approved
Delia YoderEquipment Storage$11,460Approved
The five-node graph drawn as boxes with @id arrows — Organization, WebSite, Person, BreadcrumbList, Article. Sample data — no customer information appears here.
How it works
  1. 1articleGraph(post) composes the five nodes with stable @ids anchored to the site origin.
  2. 2The Article node references the author and publisher by @id rather than repeating them.
  3. 3Word count is computed from the post body at render time.
  4. 4The graph is serialised into a single application/ld+json script on the page.
  5. 5Draft previews return noindex metadata instead, so an unpublished post never enters the graph.
Why we built it

The reasoning is explicit: "Search engines and AI answer engines both resolve a page to an ENTITY before they trust it. Article markup alone says 'this is a post'; it never says who wrote it, what company stands behind it, or what that company does — which is exactly what an assistant needs before it will name us in an answer rather than paraphrasing us anonymously." The stable ids are the mechanism: "they let a consumer collapse ten pages into one publisher instead of ten unrelated documents."

The problem
  • Article markup alone gives a consumer no publisher identity.
  • Ten pages read as ten unrelated documents rather than one publisher.
  • The intended audience of an article had to be inferred.
Sound familiar?
What you get
Every article resolves to a named organisation and a named author
The audience is stated rather than guessed
Answer surfaces are told which sections are safe to read aloud

See it on your own jobs

Twenty minutes, your numbers, no slide deck. We’ll build one of your real buildings in front of you and send you the estimate link at the end — yours to keep either way.

or keep browsing features →