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

# Structured Data Quick Reference

One-page reference for all structured data implementation.

---

## 🎯 Quick Commands

```bash
# 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