Connected @graph Architecture: mainEntityOfPage, isPartOf & Deterministic @ids
Isolated JSON-LD blocks force crawlers to guess whether a Product, Author, and Organization on the same page belong to the same entity.
Dmitry K., Technical SEO Lead · SEO Space
Indexation benchmark targets
- Single payload
- Unified @graph array
- Primary subject
- mainEntityOfPage / mainEntity
- Site link
- isPartOf -> #website
Turning Fragmented Snippets into an Explicit Knowledge Graph
Most CMS sites emit three or four independent `<script type="application/ld+json">` tags rendered by unrelated plugins—one for breadcrumbs, one for SEO meta, one for reviews, and another for authors. Search engines see orphaned islands instead of a cohesive semantic statement.
Wrapping entities in a single `@graph` array and linking them via deterministic `#fragment` `@id` URIs (`#website`, `#organization`, `#webpage`, `#article`, `#author`) turns every URL into a cleanly connected node.
{
"@context": "https://schema.org",
"@graph": [
{ "@type": "Organization", "@id": "https://example.com/#org", "name": "Example Lab" },
{ "@type": "WebSite", "@id": "https://example.com/#site", "publisher": { "@id": "https://example.com/#org" } },
{ "@type": "WebPage", "@id": "https://example.com/blog/graph/#page", "isPartOf": { "@id": "https://example.com/#site" } },
{ "@type": "TechArticle", "@id": "https://example.com/blog/graph/#article", "mainEntityOfPage": { "@id": "https://example.com/blog/graph/#page" }, "publisher": { "@id": "https://example.com/#org" } }
]
} Rules for Stable @id Construction Across Locales
Keep `@id` anchors immutable across redesigns while aligning localized `WebPage` nodes strictly to each regional canonical URL.
- Anchor shared global brand entities (`#organization`, `#website`) to your primary root domain across all language folders.
- Anchor page-specific entities (`#webpage`, `#product`, `#article`) to the exact canonical URL of that localized route.
- Assert `mainEntity` on `ProfilePage`, `Product`, and `FAQPage` containers so crawlers know the primary intent immediately.
Disconnected vs. Connected Graph Comparison
Compare crawler interpretation overhead before and after adopting unified `@graph` IDs.
| Property | Orphaned JSON-LD Blocks | Unified @graph Architecture |
|---|---|---|
| Organization Duplication | Re-declared 5x per page | Referenced cleanly via #organization @id |
| Page Subject Clarity | Inferred heuristically | Explicit mainEntityOfPage linkage |
| Plugin Conflicts | Frequent duplicate ratings/breadcrumbs | Single typed TypeScript generator |
Need this indexation setup audited on your domain?
Send your website URL. We check raw HTML parity, log crawl hits, canonical discipline, and sitemap architecture manually within 24 hours.