Overview

A single number (0-100) that represents the overall schema health of your site. Aggregated from individual validation scores across all URLs, weighted by recency and importance.

How It Works

1. Individual URL scores are collected from validation history
2. Scores are weighted by:
– Recency (recent validations weigh more)
– Page importance (homepage, key landing pages)
3. A weighted average produces the site-wide score
4. Score is displayed on the dashboard as the primary health metric

Tier Availability

| Tier | Available |
|——|———–|
| Free | No |
| Pro | Yes |
| Agency | Yes |
| Enterprise | Yes |

Related Features

– Schema Completeness Score: Per-URL scoring that feeds the aggregate
– Trends & Temporal Data: Score evolution over time
– Competitor Analysis: Compare your score vs competitors

Mini-Tutorial

Step 1: Check Your Current Score

Navigate to your dashboard. The Site-Wide Score is prominently displayed as a single metric (0-100).

Step 2: Understand the Calculation

Your score is computed from:
– Validity rate (50%): Percentage of URLs with valid schema
– Type coverage (30%): Diversity of schema types used (up to 25 unique types capped at 100%)
– Error density (20%): Inverse of average validation errors

Step 3: Identify Score Drivers

Click into the score breakdown to see which components need attention. For example, if type coverage is low, add more schema types to key pages.

Step 4: Track Improvement

Check trends to see if your score is improving or declining over time. A 15-day vs prior-15-day comparison reveals momentum.

Technical Details

Formula Calculation

SiteHealthScore = (validity_rate × 0.5) + (type_coverage × 0.3) + (error_density × 0.2)

Where:
- validity_rate = valid_count / total_count
- type_coverage = min(unique_types_used / 25, 1.0)  // capped at 25 types
- error_density = max(0, 100 - (avg_errors_per_url × 20))

Request

GET /api/v1/site-score?project_id=abc123

Response Example

{
  "score": 78,
  "trend": {
    "current_period": 78,
    "previous_period": 72,
    "change": 6,
    "direction": "up"
  },
  "breakdown": {
    "validity_rate": 0.95,
    "type_coverage": 0.72,
    "error_density": 92.0
  },
  "component_scores": {
    "validity": 47.5,
    "coverage": 21.6,
    "errors": 18.4
  },
  "last_updated": "2025-03-22T14:30:00Z",
  "sample_size": 156
}

Interpreting the Response

– trend.change > 0: Score improving (positive momentum)
– trend.change < 0: Score declining (needs attention)
– breakdown.validity_rate < 0.85: Many URLs have schema errors
– breakdown.type_coverage < 0.5: Limited schema diversity

References

– Schema.org Implementation Guide
– Google’s Structured Data Quality Guidelines
– Schema Validator Tools
– JSON-LD 1.1 Specification