CompanySite/.agents/seo-specialist/VALIDATION_CHECKLIST.md

Structured Data Validation Checklist

Quick reference for validating structured data and rich snippets after deployment.

---

Pre-Deployment Validation

1. Build the Site

npm run build

2. Run Automated Validation

npm run validate:structured-data

Expected Result: ✅ All validations passed

3. Preview Locally

npm run preview

Visit http://localhost:4321 and inspect:

• View page source on homepage, blog post, about page
• Verify JSON-LD scripts are present
• Check Open Graph meta tags
• Verify Twitter Card meta tags

---

Post-Deployment Validation

Google Rich Results Test

Test each page type:

1. Homepage - https://workroot.in/

   • No errors
   • Organization schema valid
   • WebSite schema valid
   • FAQPage schema valid (if present)
   • SearchAction present

2. Blog Post - https://workroot.in/blog/[any-post]

   • No errors
   • BlogPosting schema valid
   • Author (Person) present
   • Publisher (Organization) with logo
   • BreadcrumbList valid
   • Image dimensions present

3. About Page - https://workroot.in/about

   • No errors
   • AboutPage schema valid
   • BreadcrumbList valid

4. Contact Page - https://workroot.in/contact

   • No errors
   • ContactPage schema valid

5. Services Page - https://workroot.in/services

   • No errors
   • Service schema valid (if implemented)
   • WebPage schema valid

Tool: https://search.google.com/test/rich-results

---

Schema.org Validator

Test JSON-LD directly:

1. Visit any page on workroot.in
2. View page source (Ctrl+U / Cmd+U)
3. Copy JSON-LD script content (between <script type="application/ld+json"> tags)
4. Paste into https://validator.schema.org/
5. No errors
6. No warnings (warnings acceptable, but review them)

---

Open Graph Validation

Facebook Sharing Debugger

URL: https://developers.facebook.com/tools/debug/

Test each page type:

• Homepage renders with correct image
• Blog posts show featured image
• All pages have title and description
• Images are 1200x630px (optimal)
• No warnings about missing tags

LinkedIn Post Inspector

URL: https://www.linkedin.com/post-inspector/

• Pages render correctly
• Images display properly
• Title and description accurate

---

Twitter Card Validation

URL: https://cards-dev.twitter.com/validator

Test pages:

• Homepage shows large image card
• Blog posts display with featured image
• Title and description correct
• @workroot site attribution present

---

Google Search Console

After 24-48 hours of deployment:

1. Enhancements Section

   • Check for structured data errors
   • Review warnings (fix if critical)
   • Monitor enhancement impressions

2. Coverage Report

   • All pages indexed
   • No indexing errors

3. Rich Results

   • Monitor rich result impressions
   • Track click-through rate improvements

4. Sitemaps

   • Sitemap submitted and processed
   • No sitemap errors

---

Manual Visual Inspection

Google Search Results (after indexing)

Search for: site:workroot.in

Check for:

• Organization knowledge panel appears
• Sitelinks search box present
• Breadcrumbs visible in results
• Blog posts show author and date
• Star ratings appear (if applicable)

---

Common Issues & Fixes

Issue: "Missing required field 'image'"

Fix: Ensure BlogPosting schema includes image with dimensions

"image": {
  "@type": "ImageObject",
  "url": "https://workroot.in/image.jpg",
  "width": 1200,
  "height": 675
}

Issue: "Invalid URL"

Fix: Use absolute URLs, not relative

• ❌ /images/logo.png
• ✅ https://workroot.in/images/logo.png

Issue: "Date not in ISO 8601 format"

Fix: Use .toISOString() for dates

• ❌ "2024-03-15"
• ✅ "2024-03-15T10:00:00Z"

Issue: Open Graph image not showing

Fix:

1. Image must be publicly accessible (test in incognito)
2. Use HTTPS URLs
3. Recommended size: 1200x630px
4. Include og:image:secure_url

Issue: Twitter Card not rendering

Fix:

1. Verify twitter:card is summary_large_image
2. Image must be < 5MB
3. Image aspect ratio 2:1 or 1:1
4. Wait for Twitter to crawl (can take a few hours)

---

Validation Schedule

Immediate (After Deployment)

• Run all validation tools
• Test social sharing manually
• Submit sitemap to Search Console

Weekly (First Month)

• Check Search Console for errors
• Monitor rich result impressions
• Review indexed pages

Monthly (Ongoing)

• Validate key pages with Rich Results Test
• Check for broken structured data
• Update aggregate ratings if needed
• Review and refresh FAQ content

Quarterly

• Full structured data audit
• Update Organization schema (team, services)
• Validate all schema types
• Test social sharing on all platforms

---

Quick Test Commands

# Build and validate
npm run build && npm run validate:structured-data

# Local preview
npm run preview

# Run specific Playwright tests (if created)
npm run test

# Run only SEO-related tests
npm run test -- --grep "structured data"

---

Key URLs for Testing

Live Site:

• Homepage: https://workroot.in/
• Blog: https://workroot.in/blog
• About: https://workroot.in/about
• Contact: https://workroot.in/contact
• Services: https://workroot.in/services

Validation Tools:

• Google Rich Results: https://search.google.com/test/rich-results
• Schema Validator: https://validator.schema.org/
• Facebook Debugger: https://developers.facebook.com/tools/debug/
• Twitter Validator: https://cards-dev.twitter.com/validator
• LinkedIn Inspector: https://www.linkedin.com/post-inspector/

Monitoring:

• Google Search Console: https://search.google.com/search-console
• Google Analytics: (your GA property)

---

Success Criteria

Minimum Requirements (Must Pass)

• ✅ No errors in Google Rich Results Test
• ✅ Valid JSON-LD syntax (Schema.org validator)
• ✅ Organization and WebSite schemas on all pages
• ✅ Open Graph tags present on all pages
• ✅ Twitter Card tags present on all pages

Optimal Performance (Should Pass)

• ✅ Blog posts eligible for article rich results
• ✅ FAQ rich results on homepage
• ✅ Breadcrumbs in search results
• ✅ Knowledge panel for organization
• ✅ Sitelinks search box enabled

Excellence (Nice to Have)

• ✅ Star ratings in search results
• ✅ Featured snippets from FAQ
• ✅ Author bylines on blog posts
• ✅ Social sharing generates perfect previews
• ✅ Zero warnings in all validators

---

Last Updated: 2026-03-21 Next Review: After deployment