This chapter covers the core features and capabilities of Structured Data Validator.
blocks# Validate a JSON-LD file
python src/structured_data_validator.py --input examples/sample_jsonld.json
# Validate JSON-LD embedded in an HTML page
python src/structured_data_validator.py --input examples/sample_page.html
# Get a JSON report (great for CI/CD)
python src/structured_data_validator.py --input examples/sample_jsonld.json --format json
# Strict mode — fail on any warning
python src/structured_data_validator.py --input examples/sample_jsonld.json --strict
# Write report to file
python src/structured_data_validator.py --input examples/sample_jsonld.json --output report.txtFollow this guide to get Structured Data Validator up and running in your environment.
| Type | Required Fields | Recommended Fields |
|---|---|---|
| Article | headline, datePublished, author | dateModified, image, publisher, description |
| Product | name | description, image, sku, brand, offers |
| FAQPage | mainEntity | — |
| BreadcrumbList | itemListElement | — |
| Organization | name | url, logo, contactPoint, sameAs |
| LocalBusiness | name, address | telephone, openingHours, geo, url |
| WebSite | name, url | potentialAction, description |
| Event | name, startDate, location | endDate, description, image, organizer |
| Recipe | name, recipeIngredient, recipeInstructions | image, author, prepTime, cookTime |
| VideoObject | name, description, thumbnailUrl, uploadDate | contentUrl, duration, embedUrl |
| Person | name | url, image, jobTitle |
| SoftwareApplication | name | operatingSystem, applicationCategory, offers |
| Flag | Description |
|---|---|
--input, -i | Path to JSON-LD or HTML file (required) |
--format, -f | Output format: text or json (default: text) |
--output, -o | Write output to file instead of stdout |
--strict | Exit 1 if any warnings found (not just errors) |
--quiet, -q | Only show errors, suppress warnings and info |
--verbose, -v | Enable debug logging |
Get the full Structured Data Validator and unlock everything.
Get the complete guide with every chapter unlocked, including code samples, diagrams, and best practices.
Access all interactive tools with complete data, all workload profiles, and the full scenario library.
Downloadable source code, configuration files, and working examples from every chapter.
Free updates for life. Every new chapter, tool, and improvement included.