How to Set Up FAQ Schema Markup in AEO God Mode

AEO God Mode automatically detects FAQ-style content in your posts and generates FAQPage schema without any manual configuration. This guide explains how the detection works and how to write content that triggers it.

How FAQ Auto-Detection Works

The schema engine’s detect_faq_schema() method scans your post content and tries 8 different extraction strategies to find question-and-answer pairs:

• H2/H3 question headings — Headings that end with a question mark, followed by paragraph content as the answer
• Bold question patterns — Lines starting with bold text phrased as a question (e.g., What is AEO?)
• Toggle/accordion blocks — WordPress toggle blocks or accordion HTML patterns containing Q&A content
• Definition lists —
  and

  pairs where the term is a question
• Gutenberg FAQ blocks — Native WordPress FAQ block output
• Question-word patterns — Paragraphs starting with “What,” “How,” “Why,” “When,” “Where,” “Who,” “Can,” “Does,” “Is,” or “Should” followed by a question mark
• Structured Q&A HTML — Divs with FAQ-related CSS classes
• Colon-separated pairs — Lines formatted as “Question: answer”

The detector requires at least 2 valid Q&A pairs to generate FAQPage schema. Single questions alone don’t trigger it.

Writing Content That Triggers FAQ Schema

The most reliable way to trigger FAQ detection:

Method 1: Question Headings (Recommended)

Use H2 or H3 headings phrased as questions:

<h2>What is Answer Engine Optimization?</h2>
<p>Answer Engine Optimization (AEO) is the practice of optimizing your content
so AI systems like ChatGPT, Perplexity, and Google AI Overviews can find,
understand, and cite your website accurately.</p>

<h2>How does AEO differ from traditional SEO?</h2>
<p>Traditional SEO focuses on ranking in search engine results pages. AEO
focuses on getting your content cited by AI systems that generate direct
answers to user questions.</p>

Method 2: Bold Questions

<p><strong>What schema types does AEO God Mode generate?</strong></p>
<p>AEO God Mode auto-generates Article, FAQPage, HowTo, Person,
BreadcrumbList, WebSite, and Organization schema types.</p>

Method 3: WordPress Toggle Blocks

Use the built-in WordPress Details/Toggle block. Each toggle summary becomes the question, and the toggle content becomes the answer.

What the Generated Schema Looks Like

When FAQ pairs are detected, the plugin outputs this JSON-LD in your page head:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "What is Answer Engine Optimization?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Answer Engine Optimization (AEO) is the practice of..."
      }
    },
    {
      "@type": "Question",
      "name": "How does AEO differ from traditional SEO?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Traditional SEO focuses on ranking..."
      }
    }
  ]
}

Viewing FAQ Schema for a Post

• Go to AEO God Mode > Schema (admin.php?page=aeo-god-mode#/schema)
• Select the post you want to check
• If FAQ pairs were detected, you’ll see the FAQPage schema in the preview

Interaction with Other Plugins

If Yoast SEO or Rank Math is active, the schema engine checks whether they already output FAQPage schema. Both plugins only generate FAQPage from their own dedicated FAQ blocks, not from regular content, so in practice AEO God Mode’s auto-detection works alongside them without duplicates.

You can control this explicitly:

• Go to AEO God Mode > Conflicts (admin.php?page=aeo-god-mode#/conflicts)
• In the Schema Comparison section, find FAQPage
• Set it to Ours, Theirs, or Both

The default recommendation is “Ours” since only AEO God Mode auto-detects FAQ content from natural writing patterns.

Content Gap Scanner Integration

The Content Gap Scanner checks every post for FAQ opportunities. If a post has question-like content that could become proper FAQ schema but isn’t structured correctly, it flags a faq_opportunity gap. You can see these on the Content Gaps page.

Troubleshooting

FAQ schema not detected on a post with questions:

• Make sure you have at least 2 Q&A pairs
• Questions should end with a question mark
• Each question needs a clear answer paragraph directly following it
• Check that the Schema module is enabled in Settings

FAQ schema detected but includes wrong content:

• The auto-detector may pick up non-FAQ content if it matches question patterns
• Use the Schema page to review what pairs were extracted
• You can override the schema for that specific post if needed