Section: FAQ

Render a collapsible accordion of frequently asked questions. Answers support Markdown formatting including bold, links, and lists.

Props

Name	Type	Required	Description	Default
`label`	string	No	Small label above heading	—
`heading`	string	No	Section heading	—
`description`	string	No	Section description	—
`faqs`	array	Yes	Array of FAQ objects	—
`faqs[].question`	string	Yes	The question text	—
`faqs[].answer`	string	Yes	The answer (supports markdown)	—
`className`	string	No	Custom CSS class	—

Minimal Example

{
  "type": "faq",
  "faqs": [
    { "question": "What is PageGun?", "answer": "PageGun is an API-first site builder." }
  ]
}

Full Example

{
  "type": "faq",
  "label": "FAQ",
  "heading": "Frequently Asked Questions",
  "description": "Everything you need to know about PageGun.",
  "faqs": [
    {
      "question": "What is PageGun?",
      "answer": "PageGun is a programmatic site builder that lets you create landing pages, blogs, docs, and directories via API. It's designed for developers and AI agents."
    },
    {
      "question": "Can I use my own domain?",
      "answer": "Yes! Connect a custom domain with automatic SSL provisioning. You can use [Full Host mode](/docs/concepts/hosting) for a dedicated site or [Rewrite mode](/docs/concepts/hosting) to embed pages in your existing app."
    },
    {
      "question": "What page types are supported?",
      "answer": "PageGun supports 4 page types:\n\n- **page** — Landing pages with JSON sections\n- **article** — Blog posts in Markdown\n- **docs** — Documentation with navigation\n- **item** — Directory entries with custom attributes"
    },
    {
      "question": "Is there a free plan?",
      "answer": "Yes, PageGun offers a free tier with up to 10 pages per project."
    },
    {
      "question": "How does Data Mode work?",
      "answer": "Data Mode turns PageGun into a headless CMS. Content is AES-256-GCM encrypted and stored on a public CDN. Your app fetches and decrypts it client-side. [Learn more](/docs/concepts/hosting)."
    }
  ]
}

SEO Benefits

FAQ sections can improve your search rankings:

Rich snippets: Search engines may display FAQ items directly in search results
Long-tail keywords: Questions naturally match how people search
Page dwell time: Expandable content keeps users engaged

Tips for SEO-Optimized FAQs

Use real questions your users actually ask (check support tickets, search queries)
Include keywords naturally in both questions and answers
Link to detailed pages in answers for deeper engagement
Keep answers concise — 2-3 sentences for simple questions, up to a short paragraph for complex ones
Order by relevance — put the most common questions first

Writing Tips

Write questions in the user's voice — "How do I..." not "How does one..."
Answer directly — start with the answer, then add context
Use markdown in answers: bold key points, add links to related content, use lists for multi-part answers
5-8 FAQs is the sweet spot. Too few looks empty, too many is overwhelming

Placement

Usually placed near the bottom of a landing page, before the final CTA section. FAQs help address remaining objections before the user takes action.