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

Structured Data Quick Reference

One-page reference for all structured data implementation.

---

🎯 Quick Commands

# Build site
npm run build

# Validate schemas
npm run validate:schema

# Test locally
npm run preview

---

📊 Schema Summary

Page	Schemas Implemented
All Pages	Organization, WebSite
Homepage	+ FAQPage
Blog Posts	BlogPosting, BreadcrumbList, Person, ImageObject
Services	Service, BreadcrumbList, WebPage
About	AboutPage, BreadcrumbList
Contact	ContactPage, BreadcrumbList

---

🔗 Testing Tools

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

---

✅ Quick Validation Checklist

Homepage

• Organization schema
• WebSite schema with search action
• FAQPage schema (6 questions)
• Open Graph tags
• Twitter Cards

Blog Posts

• BlogPosting (not Article)
• Author Person schema
• Image with dimensions
• Published/modified dates
• Tags and category
• Breadcrumbs
• OG image 1200x630px

Services

• Service schema per service
• Provider organization
• Breadcrumbs
• WebPage schema

About/Contact

• AboutPage/ContactPage schema
• Breadcrumbs
• Organization reference

---

📝 Key Files

src/
├── layouts/
│   └── BaseLayout.astro         # Organization, WebSite schemas
├── components/
│   └── SEO.astro                # Page-specific schemas
└── pages/
    ├── index.astro              # FAQPage
    ├── blog/[...slug].astro     # BlogPosting
    ├── services.astro           # Service
    ├── about.astro              # AboutPage
    └── contact.astro            # ContactPage

.agents/seo-specialist/
├── STRUCTURED_DATA.md           # Full documentation
├── VALIDATION_GUIDE.md          # Testing guide
├── QUICK_REFERENCE.md           # This file
└── test-schema.html             # Testing interface

scripts/
└── validate-schema.js           # Validation script

---

🎨 Open Graph Images

Required Sizes:

• Facebook/LinkedIn: 1200x630px
• Twitter Card: 1200x630px or 1200x675px
• Minimum: 200x200px
• Maximum: 8MB file size

Format: JPG or PNG

---

🔍 Search Console Setup

1. Add property: https://workroot.in
2. Verify ownership (DNS/HTML/Analytics)
3. Submit sitemap.xml
4. Monitor Enhancements → Rich Results

---

📈 Expected Rich Results

Schema	Rich Result
Organization	Knowledge Graph Panel
WebSite	Sitelinks Search Box
BlogPosting	Article Card, Top Stories
BreadcrumbList	Breadcrumb Navigation
FAQPage	FAQ Accordion
Service	Enhanced Listings

---

⚠️ Common Issues

Issue	Fix
"Missing required property"	Add the required field to schema
"Invalid URL"	Use absolute URLs (https://...)
"Image too small"	Use 1200x630px minimum
"Missing breadcrumb position"	Start at 1, increment by 1
"Publisher logo missing"	Add ImageObject to publisher
"OG image not loading"	Verify URL, clear Facebook cache

---

🚀 Deployment Checklist

Pre-deployment:

• Run npm run validate:schema
• Test all pages with Google Rich Results
• Verify Open Graph previews
• Check Twitter Card previews
• Build passes with no errors

Post-deployment:

• Submit sitemap to Search Console
• Monitor for structured data errors
• Test live URLs with validators
• Check social sharing on live site

---

📞 Support

Documentation: .agents/seo-specialist/STRUCTURED_DATA.md Testing Guide: .agents/seo-specialist/VALIDATION_GUIDE.md Test Interface: .agents/seo-specialist/test-schema.html

Resources:

• Schema.org: https://schema.org/
• Google Docs: https://developers.google.com/search/docs/appearance/structured-data
• Open Graph: https://ogp.me/

---

Last Updated: 2026-03-21