Session Date: 2025-11-30
Project: Multi-site Schema.org Knowledge Graph
Focus: Creating cross-domain entity relationships using @id references
Executive Summary
This session focused on building a distributed knowledge graph across multiple websites by implementing Schema.org JSON-LD with proper @id references that enable entities to reference each other across domain boundaries. The work spanned four interconnected sites: PersonalSite (aledlie.com), IntegrityStudio.ai, Leora Home Health, and Inspired Movement Dance Studio.
The key achievement was establishing bidirectional entity references where a review on one site (IntegrityStudio.ai) references an author entity (Person) defined on another site (Leora Home Health), and that person references back to the organization they own—creating a true distributed semantic web of relationships.
The Vision: Distributed Knowledge Graphs
Traditional Schema.org implementations treat each website as an isolated entity graph. This session explored a more powerful pattern: using canonical @id URIs that allow entities across different domains to reference each other, building a web of interconnected knowledge that search engines and AI systems can traverse.
The Pattern
Site A (integritystudio.ai) Site B (leorahomehealth.com)
───────────────────────────── ────────────────────────────
Review Person
└─ author: @id ────────────────────→ @id: leorahomehealth.com#owner-monica
└─ itemReviewed: @id ──┐ └─ worksFor: @id ─→ Organization
│ └─ affiliation ───→ Organization
Organization ←───────────┘ Organization
└─ @id matches exactly ────────────→ @id: leorahomehealth.com#organization
Implementation Details
1. PersonalSite Schema Enhancement
Initial Score: 62/100 → Final Score: 78.6/100
Added entities and fixed references:
{
"@type": "ProfilePage",
"@id": "https://www.aledlie.com/about#profilepage",
"mainEntity": { "@id": "https://www.aledlie.com#person" },
"isPartOf": { "@id": "https://www.aledlie.com#website" }
}
{
"@type": "CollectionPage",
"@id": "https://www.aledlie.com/projects#collectionpage",
"about": { "@id": "https://www.aledlie.com#person" }
}
Key Fix: Updated Integrity Studio reference to use canonical @id:
"worksFor": [
{ "@id": "https://www.integritystudio.org/#organization" }
]
2. Cross-Site Organization Sync
Ensured @id values match exactly between PersonalSite and IntegrityStudio.ai:
PersonalSite references:
"worksFor": [
{ "@id": "https://www.integritystudio.org/#organization" },
{ "@id": "https://www.aledlie.com/organizations/inventoryai#organization" }
]
IntegrityStudio.ai defines:
{
"@type": "Organization",
"@id": "https://www.integritystudio.org/#organization",
"name": "Integrity Studio",
...
}
3. Contact Information Standardization
Added consistent contact info across all organization entities:
- Phone:
+1-512-829-1644 - Email:
hello@integritystudio.ai(updated from@theintegritystudio.com) - Address: Austin, TX, US
4. Cross-Domain Review with External Author
The most interesting implementation—a review on IntegrityStudio.ai that references an author defined on a different domain:
IntegrityStudio.ai (schema-structured-data.json:754-771):
{
"@type": "Review",
"@id": "https://www.integritystudio.org/#review-4",
"itemReviewed": {
"@id": "https://www.integritystudio.org/#organization"
},
"author": {
"@id": "https://www.leorahomehealth.com#owner-monica-herra-hernandez"
},
"reviewBody": "Integrity Studio completely transformed how we present Leora Home Health Care online...",
"datePublished": "2025-11-30"
}
Leora Home Health (schema-org-markup-v2.json:354-363):
{
"@type": "Person",
"@id": "https://www.leorahomehealth.com#owner-monica-herra-hernandez",
"name": "Monica Herra-Hernandez",
"honorificSuffix": "RN",
"jobTitle": "Owner",
"worksFor": { "@id": "https://www.leorahomehealth.com#organization" },
"affiliation": { "@id": "https://www.leorahomehealth.com#organization" }
}
5. Full Organization Entity in External Schema
Added complete Leora Home Health organization to IntegrityStudio.ai schema (schema-structured-data.json:772-800):
{
"@type": ["MedicalOrganization", "LocalBusiness"],
"@id": "https://www.leorahomehealth.com#organization",
"name": "Leora Home Health",
"url": "https://www.leorahomehealth.com",
"description": "Compassionate in-home health care services in Central Texas...",
"telephone": "+1-512-222-8103",
"email": "appointments@leorahomehealth.com",
"founder": {
"@id": "https://www.leorahomehealth.com#owner-monica-herra-hernandez"
},
"sameAs": [
"https://www.facebook.com/leorahomehealth",
"https://www.instagram.com/leorahomehealth",
"https://www.linkedin.com/company/leora-home-health"
]
}
The Complete Entity Relationship Map
PersonalSite (aledlie.com)
├── Person (@id: aledlie.com#person)
│ ├── worksFor ──────────────────────────────────────┐
│ ├── worksFor ─→ InventoryAI Organization │
│ └── owns ─→ WebSite │
├── WebSite (@id: aledlie.com#website) │
│ └── hasPart ─→ [Blog, ProfilePage, CollectionPage]│
└── Organization references ────────────────────────────┼─────────────────────┐
│ │
IntegrityStudio.ai │ │
├── Organization (@id: integritystudio.org/#organization) ←──────────────────┘
│ ├── review ─→ [#review-1, #review-2, #review-3, #review-4]
│ └── hasOfferCatalog ─→ Services
├── Review #review-4
│ ├── author ─────────────────────────────────────────────────────────────┐
│ └── itemReviewed ─→ Organization │
└── Leora Organization (mirror) ───────────────────────────────────────────┐│
└── founder ───────────────────────────────────────────────────────────┐││
│││
Leora Home Health │││
├── Organization (@id: leorahomehealth.com#organization) ←─────────────────┘││
│ ├── founder ─→ Monica Herra-Hernandez ││
│ └── hasOfferCatalog ─→ [PAS, HHA, Skilled Nursing, etc.] ││
├── Person: Monica Herra-Hernandez (@id: ...#owner-monica...) ←────────────┘│
│ ├── worksFor ─→ Organization │
│ └── affiliation ─→ Organization │
└── (matches mirror in IntegrityStudio.ai) ←────────────────────────────────┘
Files Modified
| File | Location | Changes |
|---|---|---|
unified-knowledge-graph-schema.html |
PersonalSite/_includes/ | Added ProfilePage, CollectionPage, updated org references |
personal-site-schema.json |
PersonalSite/schema/ | Static snapshot with all enhancements |
schema-structured-data.json |
IntegrityStudio.ai/docs/schema/ | Added review #4, Leora org, updated contact info |
schema-org-markup-v2.json |
IntegrityStudioClients/Leora/ | Added Monica Herra-Hernandez Person, founder reference |
Key Design Decisions
1. Canonical @id URIs
Used full URLs with hash fragments as @id values. This allows:
- Cross-domain references without ambiguity
- Search engines to potentially crawl and link entities
- Future federation of knowledge graphs
2. Mirror Entities
When referencing external entities heavily (like in a review), include a “mirror” of the referenced entity in the local schema. This:
- Provides context if the external schema isn’t crawled
- Ensures rich snippets work even without cross-domain resolution
- Maintains the @id consistency for when resolution does work
3. Bidirectional References
Always create relationships in both directions where appropriate:
- Review → Author (via @id)
- Person → Organization (via worksFor)
- Organization → Person (via founder)
SEO and Knowledge Graph Benefits
- Rich Snippets: Review markup with proper author references enhances SERP display
- Entity Understanding: Search engines can understand organizational relationships
- Knowledge Panel Potential: Connected entities may contribute to knowledge panel data
- AI Comprehension: LLMs can better understand the business relationships and context
Metrics
| Site | Initial Score | Final Score | Improvement |
|---|---|---|---|
| PersonalSite | 62/100 | 78.6/100 | +16.6 |
| IntegrityStudio.ai | 100/100 | 100/100 | maintained |
| Leora Home Health | - | enhanced | +founder link |
Next Steps
- Validate with Google Rich Results Test: Ensure all cross-domain references render correctly
- Add more client reviews: Continue pattern of external author references
- Inspired Movement integration: Link dance studio schema to PersonalSite projects
- Monitor Search Console: Track entity recognition improvements
- Consider Schema.org Actions: Add potential actions for booking/contact
References
- ID Schema for SEO, LLMs, Knowledge Graphs
- PersonalSite:
/Users/alyshialedlie/code/PersonalSite/_includes/unified-knowledge-graph-schema.html - IntegrityStudio.ai:
/Users/alyshialedlie/code/ISPublicSites/IntegrityStudio.ai/docs/schema/schema-structured-data.json - Leora:
/Users/alyshialedlie/code/IntegrityStudioClients/Leora/schema-org-markup-v2.json - Inspired Movement:
/Users/alyshialedlie/code/IntegrityStudioClients/InspiredMovement/schema/dance-studio-schema.json