← Back

How to Create an FAQ Section

Sections•Beginner•8 min read

How to Create an FAQ Section

An FAQ (Frequently Asked Questions) Section helps visitors find answers quickly using an accordion-style interface.

What you'll create:

The finished FAQ Section with expandable accordion questions

Overview

FAQ sections reduce support tickets, build trust, and improve SEO. Questions are displayed in a collapsible accordion format - click to expand and see the answer.

Key features:

  • Accordion/collapse interface
  • Section heading and description
  • Pull from Sanity FAQ documents
  • Mobile-friendly expandable answers
  • Search-friendly content
  • Organized by topics/categories

Quick Setup

  1. Add Section: Pages → Your Page → Sections → Add "FAQ Section"
  2. Add Heading: "Frequently Asked Questions"
  3. Select FAQs: Choose from existing FAQ documents
  4. Publish

Step 1: Create FAQ Documents

  1. Go to Content → FAQs in Sanity Studio
  2. Click Create New FAQ
  3. Fill in:

- Question: The question customers ask

- Answer: Clear, helpful answer

- Category (optional): Group related FAQs

- Order: Display sequence

Create 5-10 FAQs covering common questions.

Step 2: Configure Section

Heading

  • "Frequently Asked Questions"
  • "Common Questions"
  • "Got Questions? We've Got Answers"

Description (Optional)

  • "Find quick answers to common questions."
  • "Can't find what you're looking for? Contact us."

Step 3: Select FAQs

  1. Click "Add" in FAQs field
  2. Select 5-15 FAQ documents
  3. Order by importance (most asked first)

Writing Effective FAQs

Questions

✅ DO:

  • Use customer's exact wording
  • Start with who/what/when/where/why/how
  • Be specific, not vague
  • Address real concerns

Example questions:

  • "How long does setup take?"
  • "What payment methods do you accept?"
  • "Can I cancel my subscription anytime?"
  • "Do you offer a free trial?"

❌ DON'T:

  • Use company jargon
  • Make up fake questions
  • Be too general
  • Avoid tough questions

Answers

✅ DO:

  • Be concise (2-4 sentences)
  • Give actionable information
  • Link to detailed guides if needed
  • Use simple language

❌ DON'T:

  • Write paragraphs
  • Use technical terms without explaining
  • Dodge the question
  • Be overly salesy

FAQ Categories

Organize by topic:

Getting Started

  • Account setup
  • First-time use
  • Onboarding

Billing & Pricing

  • Payment methods
  • Subscription plans
  • Refunds/cancellations

Technical

  • Integrations
  • Troubleshooting
  • System requirements

Features

  • How features work
  • Limitations
  • Use cases

Example Configuration

Heading: "Frequently Asked Questions"
Description: "Quick answers to questions you may have."

FAQs (6 selected):

1. Q: "How long does setup take?"
A: "Most users are up and running in under 10 minutes. Simply connect your store, sync your products, and you're ready to sell."
Order: 1

2. Q: "What platforms do you integrate with?"
A: "We integrate with Shopify, WooCommerce, and Wix. More platforms coming soon!"
Order: 2

3. Q: "Is there a free trial?"
A: "Yes! Try Popay free for 14 days, no credit card required. Cancel anytime."
Order: 3

4. Q: "Can I use Popay for multiple locations?"
A: "Absolutely. Manage unlimited locations from one central dashboard. Each location can have its own staff, inventory, and settings."
Order: 4

5. Q: "How does billing work?"
A: "We bill monthly or annually. You can upgrade, downgrade, or cancel anytime from your account settings."
Order: 5

6. Q: "What kind of support do you offer?"
A: "Email support for all plans, with priority support and phone/chat for Pro and Enterprise customers."
Order: 6

Schema Reference

File: sanity/schemas/sections/faqSection.ts

Section fields:

  • heading (required): Portable Text
  • description: Portable Text
  • faqs (required): Array of references to FAQ documents

FAQ document fields:

  • question (required): String
  • answer (required): Text or Portable Text
  • category: String
  • order: Number

Best Practices

✅ DO:

  • Update FAQs regularly
  • Base on actual customer questions
  • Link to detailed documentation
  • Keep answers under 100 words
  • Test accordion functionality

❌ DON'T:

  • Include every possible question
  • Write novel-length answers
  • Use FAQs as a dump for all content
  • Ignore analytics (what people click)
  • Forget to update outdated info

Pro Tip: Track which FAQs get clicked most in your analytics. These are your most important questions - make sure the answers are perfect!