Overview

Never publish a post with broken schema again. When connected via the Schema Blocks plugin, ValidGraph automatically validates the page’s structured data every time a post is published or updated.

How It Works

1. Requires Schema Blocks plugin with active ValidGraph connection
2. When a post is published (or updated), the plugin triggers a validation
3. ValidGraph validates the live URL
4. Results are shown:
– As a badge in the block editor
– In the ValidGraph dashboard
5. Errors trigger alerts (if configured)

Tier Availability

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

Related Features

– Schema Blocks Plugin Connection: Required for this feature
– URL Validation: The validation engine used
– Automated Re-scans: Ongoing monitoring after initial publish validation

Mini-Tutorial

Step 1: Ensure Plugin Connection

Complete the Schema Blocks plugin integration (see Schema Blocks Plugin Connection) and verify the connection is active.

Step 2: Author a Post with Schema

In WordPress, create or edit a post and add Schema Blocks blocks (Article, Product, FAQPage, etc.).

Step 3: Publish or Update

Click “Publish” or “Update.” The plugin automatically sends the live URL to ValidGraph for validation.

Step 4: Check Validation Badge

Within 5-10 seconds, you’ll see a validation badge in the editor:
– Green checkmark: Schema is valid
– Red X: Errors found; click for details
– Yellow warning: Minor issues

Step 5: Fix Errors (If Any)

If errors appear, adjust your schema blocks and republish. The new version is validated immediately.

Step 6: Track in Dashboard

All publish-triggered validations appear in your ValidGraph history, labeled with “Source: Plugin.”

Technical Details

How It Works

When a post is saved/published, the WordPress plugin hooks into save_post and makes this API call:

POST /api/v1/validate
{
  "url": "https://example.com/blog/my-post-123/",
  "project_id": "proj_abc123",
  "source": "plugin",
  "plugin_version": "2.1.0"
}

Header required:

X-Plugin-Token: svp_1a2b3c4d5e6f...

Response:

{
  "validation_id": "val_12345",
  "url": "https://example.com/blog/my-post-123/",
  "status": "valid",
  "score": 88,
  "errors": 0,
  "warnings": 2,
  "schema_type": "Article",
  "issues": [
    {
      "level": "warning",
      "property": "author",
      "message": "Recommended property missing"
    }
  ],
  "validated_at": "2025-03-22T14:30:00Z"
}

Plugin Response Handling

The plugin displays validation status in the editor sidebar. If validation fails 3 times in a row, the plugin alerts the user via error notification.

References

– WordPress Action Hooks (save_post)
– WordPress Plugin Development Guide
– JSON-LD Best Practices for Articles
– Schema Blocks Plugin Documentation