JSON-LD Schema Markup for Rich Results

FAQ SCHEMA IMPLEMENTATION

GOAL
Rank 15 help articles for featured snippets (currently ranking 0)

STEP 1: MARKUP SETUP (JSON-LD)
Add to <head> of each help article page:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "How do I set up automated customer check-ins?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Configure your agent in Settings > Automation. Define check-in frequency (daily, weekly) and target customer segments. Agent activates immediately."
      }
    },
    {
      "@type": "Question",
      "name": "Can the agent handle objections?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Yes. The agent is trained on your responses to common objections. It recognizes patterns and escalates complex objections to a human CSM."
      }
    }
  ]
}

STEP 2: CONTENT STRUCTURE
Each answer must be:
• 40-60 words (optimal for featured snippets)
• Clear, direct language (no jargon)
• Answer the question in the first sentence
• No links or HTML in the answer text (plain text only)

STEP 3: VALIDATION
Run each page through Google's Rich Results Test
• Paste URL
• Check for errors (schema format issues)
• Verify FAQPage markup detected
• Common errors: missing text, invalid schema type

TEST RESULTS (from first 3 articles):
✓ Article 1 (setup): Schema valid, preview shows on Google
✗ Article 2 (objections): Schema valid but answer too long (98 words → trim to 50)
✓ Article 3 (billing): Schema valid, answer clear and actionable

STEP 4: SEARCH CONSOLE AUDIT
1. Submit sitemap (confirms Google knows about your help pages)
2. Monitor Search Console for "rich results"
3. Within 2-4 weeks, look for "FAQ" in results type
4. Track impressions (how often content appears in snippets)
5. Click-through rate (what percentage of impressions become clicks)

STEP 5: RANKING OPTIMIZATION
These articles need both markup AND traditional SEO:
• Page title includes target keyword ("How to Automate Customer Check-ins with AI")
• Meta description under 160 chars
• Headings use target keyword naturally
• Internal links from related articles
• Mobile-responsive (mobile-first indexing)

STEP 6: MONITORING
Three months post-launch, measure:
Featured snippet impressions in Search Console (target: 50-100/month)
Click-through rate from snippets (typically 5-8%)
Ranking position improvement (most should move to page 1 within 90 days)

SETUP GOTCHAS
Gotcha 1: If answer is HTML or contains links, schema breaks
  → Keep text plain, move links elsewhere
Gotcha 2: If Q&A pairs aren't chronological or relevant, Google ignores markup
  → Structure by user journey (setup → common issues → advanced)
Gotcha 3: Schema markup alone doesn't guarantee rankings
  → You still need good SEO (keywords, backlinks, user experience)

INSTALLATION METHOD
If using static HTML: manually add JSON-LD to each page's <head>
If using CMS (WordPress): install Yoast SEO plugin, configure FAQ blocks per post
If using Next.js: use next-seo library with faqSchema component