# FAQ Optimization Guide

**Last Updated:** 2026-01-13

Comprehensive guide for creating and optimizing FAQs for blog posts, including keyword research, question generation, answer writing, and implementation.

## Overview

This guide provides step-by-step instructions for creating SEO-optimized FAQs for blog posts, leveraging SISTRIX data, GSC queries, and best practices for SEO, AEO, and GEO optimization.

## Workflow

### Phase 1: Research & Data Collection

1. **Collect Research Data**

   ```bash
   php v2/scripts/blog/collect-faq-research-data.php --post=slug --category=category
   ```

   This collects:

   - People Also Ask questions from SISTRIX
   - Top GSC queries
   - Related keywords
   - SERP features

2. **Generate FAQ Questions**

   ```bash
   php v2/scripts/blog/generate-faq-questions.php --post=slug --category=category
   ```

   This generates 10-15 FAQ questions based on research data.

### Phase 2: Answer Writing

**Answer Requirements:**

- **Length:** 40-80 words (optimal for Featured Snippets)
- **Structure:** Direct answer → Context → Actionable info
- **Tone:** Du tone (informal German)
- **Keywords:** Natural integration, not stuffed
- **Internal Links:** 2-3 per post total, contextual
- **Ordio Mentions:** Natural, not forced

**Answer Template:**

```
[Direct answer in first sentence (10-15 words)]
[Context/details in middle sentences (20-40 words)]
[Actionable information or next steps (10-15 words)]
```

**Example:**

```
Bei einem Nettoeinkommen von 2000 € erhältst du 60% davon als Arbeitslosengeld 1, also 1200 € monatlich. Hast du Kinder, erhöht sich der Satz auf 67%, was 1340 € monatlich entspricht. Der Höchstbetrag liegt 2026 bei 2390 € (West) bzw. 2320 € (Ost). Unser Rechner zeigt dir deinen genauen Anspruch.
```

### Phase 3: Implementation

**HTML Format:**

```html
<h2>FAQ</h2>
<div class="schema-faq wp-block-yoast-faq-block">
  <div class="schema-faq-section" id="faq-question-1">
    <strong class="schema-faq-question">Question text here?</strong>
    <p class="schema-faq-answer">Answer text here (40-80 words).</p>
  </div>
  <div class="schema-faq-section" id="faq-question-2">
    <strong class="schema-faq-question">Another question?</strong>
    <p class="schema-faq-answer">Another answer...</p>
  </div>
  <!-- Repeat for 10-15 FAQs -->
</div>
```

**Implementation Steps:**

1. Add FAQs to post JSON file (`v2/data/blog/posts/{category}/{slug}.json`)
2. Insert FAQ HTML before closing `</div>` tags in `content.html`
3. Verify FAQ extraction: `extract_faqs_from_html()` should find all FAQs
4. Test FAQ display on blog post page
5. Verify schema generation

### Phase 4: Validation

**Checklist:**

- [ ] 10-15 FAQs per post
- [ ] Answers are 40-80 words each
- [ ] Natural keyword integration
- [ ] Du tone consistency
- [ ] 2-3 internal links total
- [ ] Schema validates with Google Rich Results Test
- [ ] No duplicate questions

## Question Prioritization

**Priority Order:**

1. High-volume calculation questions (first 3-5 FAQs)
2. Duration/application questions (next 3-5 FAQs)
3. Technical/context questions (remaining FAQs)

**Sources (in priority order):**

1. People Also Ask questions (SISTRIX)
2. Top GSC queries
3. Related keywords
4. Standard questions based on topic

## Keyword Integration

**Best Practices:**

- Include primary keyword naturally in questions
- Use semantic variations in answers
- Match high-volume search queries
- No keyword stuffing

**Example:**

- ✅ **GOOD:** "Wie funktioniert die Zeiterfassung per App?"
- ❌ **BAD:** "Wie funktioniert die Zeiterfassung per App Zeiterfassung App?"

## Internal Linking

**Guidelines:**

- 2-3 internal links total across all FAQs
- Links must be contextually relevant
- Use natural anchor text (not "click here")
- Target relevant tools, products, or content pages

**When to link:**

- When answer mentions related calculation
- When answer references related tool
- When answer could benefit from additional context

## Schema Validation

**Requirements:**

- All FAQs included in FAQPage schema
- Schema answers match HTML exactly (word-for-word)
- No HTML links in schema answers (plain text only)
- Valid JSON syntax
- Schema validates with Google Rich Results Test

**Validation Tools:**

- Google Rich Results Test: https://search.google.com/test/rich-results
- JSON Validator: https://jsonlint.com/

## Quality Checklist

### Content Quality

- [ ] 10-15 FAQs per post
- [ ] Answers are 40-80 words each
- [ ] Natural keyword integration
- [ ] Du tone consistency
- [ ] Natural Ordio mentions (not forced)
- [ ] 2-3 natural internal links

### SEO Quality

- [ ] FAQ ordering follows priority strategy
- [ ] Questions match People Also Ask queries
- [ ] Keywords integrated naturally
- [ ] Schema markup complete and valid
- [ ] No duplicate questions

### Technical Quality

- [ ] Each FAQ has unique ID
- [ ] Proper HTML5 structure
- [ ] Schema answers match HTML exactly
- [ ] No HTML links in schema answers
- [ ] Valid JSON syntax

## Related Documentation

- `docs/content/blog/FAQ_BEST_PRACTICES.md` - Best practices guide
- `docs/content/blog/FAQ_IMPLEMENTATION.md` - Implementation details
- `.cursor/rules/tools-pages-faq.mdc` - Tools page FAQ patterns
- `.cursor/rules/shared-patterns.mdc` - Universal copy guidelines