Testing & Validating JSON-LD Schema

Test and validate your JSON-LD schema markup to ensure it’s working correctly. Inspect individual URLs, identify errors, and verify your structured data before Google crawls it.

Schema Testing

Overview

Schema Testing helps you:

  • Validate Schema — Check if your markup is correct
  • Identify Errors — Find and fix issues before Google does
  • Test Pages — Inspect any URL on your store
  • Monitor Quality — Ensure consistent schema across pages

Accessing Schema Testing

  1. Navigate to Schema Testing from the sidebar
  2. Connect Google Search Console (optional but recommended)
  3. Enter URLs to inspect

Testing Methods

Method 1: Google Search Console Integration

Requirements:

  • Connected Google Search Console account
  • Verified property

Benefits:

  • See how Google actually views your pages
  • Access to indexing status
  • Real crawl data

How to use:

  1. Connect your Google account
  2. Select your property/domain
  3. Enter a URL from your site
  4. Click Inspect URL
  5. Review the results

Method 2: Basic Schema Validator

Requirements:

  • None (no login required)

Benefits:

  • Quick testing without authentication
  • Test any public URL
  • Instant results

How to use:

  1. Click Use Basic Schema Validator
  2. Enter the URL to test
  3. View detected schema types
  4. Review any errors or warnings

URL Inspection Tool

Entering URLs

Format requirements:

  • Use complete URLs with https://
  • URL must be from your connected property
  • Page must be publicly accessible

Examples:

✓ https://yourstore.com/products/blue-shirt
✓ https://yourstore.com/collections/summer
✓ https://yourstore.com/blogs/news/latest-post
✗ yourstore.com/products/shirt (missing https://)
✗ /products/shirt (relative URL)

Understanding Results

StatusMeaning
ValidSchema is correct and complete
Valid with warningsWorks but could be improved
ErrorSchema has issues that need fixing
Not foundNo schema detected on page

Schema Types Detected

The tool identifies these schema types:

Schema TypeFound On
OrganizationHome page
WebSiteHome page
ProductProduct pages
BreadcrumbListAll pages with breadcrumbs
ArticleBlog posts
FAQPagePages with FAQ schema
LocalBusinessIf configured
ItemListCollection pages
VideoObjectPages with video schema
RecipeRecipe content

Common Errors and Fixes

Missing Required Fields

Error: “Missing field: [fieldName]”

Common missing fields:

SchemaRequired Fields
Productname, image, offers
Organizationname, logo
Articleheadline, image, author
LocalBusinessname, address

Fix: Configure the missing information in the relevant settings page.


Invalid Field Values

Error: “Invalid value for field: [fieldName]”

Common issues:

FieldProblemSolution
priceNot a numberUse numeric value (29.99)
datePublishedWrong formatUse ISO 8601 (YYYY-MM-DD)
urlInvalid URLUse complete URL with https://
imageBroken linkVerify image URL is accessible

Duplicate Schema

Error: “Duplicate [schemaType] found”

Cause: Multiple schema blocks of same type on one page

Fix:

  1. Check theme for existing schema
  2. Disable conflicting schema in theme
  3. Or disable in app to avoid duplicates

External Testing Tools

You can also verify with:

  1. Google Rich Results Test
    • https://search.google.com/test/rich-results
  1. Schema.org Validator
    • https://validator.schema.org/
  1. Google Search Console
    • URL Inspection tool

Troubleshooting

“URL not found in property”

Cause: URL doesn’t match connected property

Solutions:

  1. Ensure URL is from your verified domain
  2. Check for www vs non-www mismatch
  3. Verify the page exists and is indexed

No schema detected

Causes:

  • App not activated in theme
  • Schema type not enabled
  • Page type mismatch

Solutions:

  1. Verify app is activated
  2. Check schema settings
  3. Ensure correct page type
  4. Clear caches and retest

Results don’t match Google

Causes:

  • Google has cached old version
  • Recent changes not crawled yet

Solutions:

  1. Request indexing in Search Console
  2. Wait for Google to re-crawl
  3. Verify changes are saved

Related Guides


Need Help?

Last updated on February 16, 2026

Was this article helpful?

PREVIOUS

Optimizing Meta Titles & Descriptions

NEXT

Shop Details Configuration

Powered by Support Genix