Overview

Visualize how entities are distributed across your website. The coverage map shows which schema types appear on which pages, identifies coverage gaps, and highlights areas where structured data could be added.

How It Works

1. Aggregates all validated schemas across the site
2. Maps entities to their source pages
3. Generates a coverage matrix:
– Rows: schema types
– Columns: page categories or URLs
4. Identifies gaps where expected schema types are missing
5. Suggests pages that should have structured data

Tier Availability

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

Related Features

– Orphan Entity Detector: Find entities without proper connections
– Entity Consistency Checker: Verify entities are described consistently

Mini-Tutorial

Analyzing and Improving Entity Coverage

1. Request the coverage map for your site:

   GET /validgraph/v1/coverage-map?site_id=abc123
   

2. Review the results — a matrix showing:
– Rows: Schema types (Organization, Product, Article, LocalBusiness, etc.)
– Columns: Page categories or specific URLs
– Cells: Coverage status (present, missing, partial)

3. Identify coverage gaps:
– Expected Product schema on product pages but missing on some
– Organization schema only on homepage, not on other pages
– Missing BreadcrumbList across all pages

4. Plan improvements:
– Homepage: Add Organization + WebSite schema
– Product pages: Add Product + Offer + Review schemas
– Blog pages: Add Article + Author schemas
– Contact page: Add Organization + ContactPoint schemas

5. Implement the missing schemas and re-validate.

Technical Details

Coverage Matrix Generation

1. Schema Aggregation: Collects all validated schemas across the site
2. Type Extraction: Identifies unique schema types (@type values)
3. Page Mapping: Maps which types appear on which pages/categories
4. Gap Analysis: Compares actual coverage against expected patterns:
– Ecommerce sites should have Product/Offer on product pages
– Publishers should have Article/NewsArticle on content pages
– Businesses should have Organization/LocalBusiness on multiple pages

5. Coverage Score: Percentage of expected schema types present on expected page types

REST API Example

Request:

GET /validgraph/v1/coverage-map?group_by=page_category

Response:

{
  "coverage": {
    "Organization": {
      "homepage": "present",
      "about": "present",
      "contact": "present",
      "product_pages": "partial"
    },
    "Product": {
      "homepage": "missing",
      "product_pages": "present"
    },
    "BreadcrumbList": {
      "all_pages": "partial"
    }
  },
  "coverage_score": 0.78,
  "missing_recommendations": [
    {
      "type": "Product",
      "pages": ["https://example.com/products/widget"],
      "priority": "high"
    }
  ]
}

References

– Schema.org Type Hierarchy
– E-commerce Structured Data
– Content-Specific Markup Guidelines