Tutorial 

Scenario 

Imagine you have a product page with detailed information about a software tool, including features, pricing, system requirements, and support options. You want to create a FAQ section that addresses common visitor questions automatically based on this content.

Step 1: Prepare your page content 

Before generating the FAQ, ensure your page has comprehensive content:

1. Create or edit a page in the TYPO3 backend

2. Add content elements with detailed information:

   • Header element - Page title and introduction
   • Text elements - Detailed descriptions of features, benefits, processes
   • Text & Media elements - Product images with descriptions
   • Additional content - Any other relevant information
3. Make sure all content is saved and published

Step 2: Add the Page FAQ element 

1. In the Page module, navigate to your content page
2. Click + Content to add a new content element
3. In the content element wizard, look for the AI3 group
4. Select Page FAQ from the available elements
5. Click Next or Save

The content element editor opens with the FAQ generator interface.

Step 3: Generate your FAQ 

1. In the FAQ generator section, you'll see:

   • A language dropdown (currently supports Deutsch)
   • A Generate FAQ button
2. Select your preferred language (Deutsch)
3. Click Generate FAQ
4. Wait for the generation process (usually 10-30 seconds)

The system will:

• Extract all content from the current page
• Send it to the ZAK-AI service
• Receive question-answer pairs
• Display them in a preview table

Step 4: Review the generated FAQ 

Once generation is complete, you'll see a preview table with:

• Question column - AI-generated questions about your content
• Answer column - Corresponding answers based on page content

Example output might include:

Step 5: Save and customize 

1. If you're satisfied with the generated FAQ, click Use FAQ Elements
2. The FAQ data is saved to the content element
3. Click Save to store the content element

4. Navigate to the Accordion tab to customize the presentation:

   • Flush - Remove borders for seamless appearance
   • Always open - Keep all items expanded by default
   • Behavior - Allow single or multiple open items

Step 6: View the result 

Navigate to your page on the frontend to see the FAQ in action:

• Questions appear as clickable accordion headers
• Clicking a question expands the answer
• The interface is responsive and accessible
• Schema.org markup is automatically included for SEO

SEO Benefits 

The generated FAQ automatically includes schema.org markup:

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Was kostet das Produkt?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Das Produkt ist in drei Preispaketen verfügbar..."
      }
    }
  ]
}

This markup enables:

• Rich snippets in Google search results
• FAQ rich results with expandable questions
• Improved click-through rates from search engines
• Enhanced local SEO for location-based questions

Tips for better results 

Troubleshooting 

Next Steps 

Once you're comfortable with basic FAQ generation, consider:

• Customizing templates - Override the accordion template for custom styling
• Adding multiple languages - Configure additional language options
• Integrating with analytics - Track FAQ interaction and user engagement
• Creating FAQ collections - Use FAQ on multiple related pages for comprehensive coverage

For advanced customization and development, see the Developer Documentation.