Add FAQ JSON-LD schema type #62

Closed
opened 2026-06-23 13:30:48 +00:00 by jmiller · 1 comment
Owner

Summary

Add FAQPage JSON-LD structured data support. FAQ schema is one of the most impactful rich snippet types — Google renders expandable Q&A directly in search results.

Why

  • Rank Math, Yoast, SEOPress, and AIOSEO all support FAQ schema (Rank Math for free)
  • FAQ rich results significantly increase SERP real estate and CTR
  • One of the most commonly requested schema types after Article/Product

Implementation

  • Add a repeatable FAQ fieldset to the content plugin form (question + answer pairs)
  • Build FAQPage schema in JsonLdBuilder
  • Output format:
{
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is...?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "It is..."
      }
    }
  ]
}
  • Consider auto-detecting FAQ blocks from article content (h3/h4 followed by paragraph)
## Summary Add `FAQPage` JSON-LD structured data support. FAQ schema is one of the most impactful rich snippet types — Google renders expandable Q&A directly in search results. ## Why - Rank Math, Yoast, SEOPress, and AIOSEO all support FAQ schema (Rank Math for free) - FAQ rich results significantly increase SERP real estate and CTR - One of the most commonly requested schema types after Article/Product ## Implementation - Add a repeatable FAQ fieldset to the content plugin form (question + answer pairs) - Build `FAQPage` schema in `JsonLdBuilder` - Output format: ```json { "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "What is...?", "acceptedAnswer": { "@type": "Answer", "text": "It is..." } } ] } ``` - Consider auto-detecting FAQ blocks from article content (h3/h4 followed by paragraph)
jmiller added this to the v2.0 — Schema & UX Expansion milestone 2026-06-23 13:30:48 +00:00
jmiller added the enhancement label 2026-06-23 13:30:48 +00:00
Author
Owner

Branch created: feature/62-add-faq-json-ld-schema-type

git fetch origin
git checkout feature/62-add-faq-json-ld-schema-type
Branch created: [`feature/62-add-faq-json-ld-schema-type`](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteOpenGraph/src/branch/feature/62-add-faq-json-ld-schema-type) ```bash git fetch origin git checkout feature/62-add-faq-json-ld-schema-type ```
Sign in to join this conversation.
Priority Medium
Type Feature
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: MokoConsulting/MokoSuiteOpenGraph#62