Overview

Orphan entities are schema objects that exist in isolation — they describe something but don’t connect to other entities on your site. This reduces the coherence of your knowledge graph and hurts AI discoverability.

How It Works

1. Builds the site-wide entity relationship graph
2. Identifies entities with no incoming or outgoing relationships
3. Categorizes orphans by type and page
4. Suggests relationships that could be added
5. Prioritizes by impact on knowledge graph completeness

Tier Availability

| Tier | Available |
|——|———–|
| Enterprise | Yes |

Related Features

– Entity Relationship Graph: Visual view of connections and orphans
– Entity Coverage Map: Where orphan entities exist
– AI Discoverability Score: Orphans reduce this score

Mini-Tutorial

Detecting and Fixing Orphan Entities

1. Fetch the orphan analysis for your site:

   GET /validgraph/v1/orphan-entities
   

2. Review the results — you’ll see a list of entities with their details:
– Entity type (Organization, Product, Article, etc.)
– Pages where they appear
– Relationship count (should be >0)

3. Identify connection opportunities:
– An Organization on your home page with no relationships → add author or publisher relationships to Articles
– A Product with no relationships → add it to a Collection or reference it from a BreadcrumbList

4. Update your structured data to add the missing connections:

   {
     "@context": "https://schema.org",
     "@type": "Article",
     "name": "Why Our Product Matters",
     "author": {
       "@type": "Organization",
       "@id": "https://example.com/org"
     }
   }
   

5. Revalidate your site to confirm orphans are eliminated.

Technical Details

How Orphan Detection Works

The system performs these operations:

1. Graph Construction: Aggregates all entities from validated pages and builds a directed graph where:
– Nodes = entities identified by @id, url, or normalized name
– Edges = reference properties (author, publisher, brand, offers, location, creator, mainEntity, parentOrganization)

2. Orphan Identification: An entity is orphan if:
– in_degree = 0 (no other entities reference it)
– out_degree = 0 (it references no other entities)

3. Impact Scoring:
– Orphans in hub entity types (Organization, WebSite, LocalBusiness) = high impact
– Orphans deeply isolated from main graph clusters = medium impact
– Orphans with common schema types (Article, Product) = lower impact

REST API Example

Request:

GET /validgraph/v1/orphan-entities?site_id=abc123

Response:

{
  "orphans": [
    {
      "@id": "https://example.com/product/widget-x",
      "@type": "Product",
      "name": "Widget X",
      "pages": ["https://example.com/products/widget-x"],
      "in_degree": 0,
      "out_degree": 0,
      "suggested_connections": [
        {
          "property": "brand",
          "target_entity": "Organization#example-corp",
          "relevance": 0.92
        }
      ]
    }
  ],
  "total_orphans": 1,
  "graph_coherence_impact": "medium"
}

References

– Schema.org Entity Properties
– Knowledge Graph Construction Best Practices
– Google Search Central: Structured Data