SaaSPattern
SaaS Component Guide

FAQ

Objection handling in a friendly format: best near pricing and CTAs.

Overview

FAQs address common objections and questions that might prevent conversion. They're particularly important near pricing sections and CTAs where users are making decisions.

FAQs should answer real questions from your sales and support teams, not hypothetical ones. Use actual customer inquiries.

Effective FAQs are concise but complete. Answer the question fully, but keep it scannable: users won't read long paragraphs.

FAQs work best when they're contextual. Pricing FAQs near pricing, technical FAQs near product sections.

The format matters: collapsible sections (accordions) are common, but consider if all FAQs should be expanded for SEO.

Best practices

Actionable guidelines to implement this component effectively.

  • Write the questions customers actually ask (sales/support logs are gold).
  • Keep answers short, with links for deeper docs (security, API, billing).
  • Include the "hard" questions: migration, data export, downtime, refunds.
  • Use collapsible sections with accessible disclosure patterns.
  • Group FAQs by topic (Pricing, Security, Technical) for easier scanning.
  • Update FAQs regularly based on new customer questions and product changes.
  • Use natural language in questions: match how customers actually ask.

Common patterns

Popular variations and approaches you'll see across successful SaaS sites.

Accordion FAQ

Collapsible sections that expand on click. Saves space and allows users to focus on relevant questions.

  • Linear: Accordion FAQ near pricing
  • Stripe: Expandable FAQ sections

Always-expanded FAQ

All questions visible at once. Better for SEO and users who want to scan everything quickly.

  • Vercel: All FAQs visible, organized by category
  • GitHub: Expanded FAQ sections

Searchable FAQ

FAQ with search functionality. Useful for sites with many questions.

  • Intercom: Searchable help center
  • Zendesk: FAQ with search and filtering

Contextual FAQ

FAQs embedded near relevant sections (pricing FAQs near pricing, security FAQs near security section).

  • Stripe: FAQs integrated into relevant page sections
  • Notion: Contextual help throughout the site

Examples

Real-world implementations from top SaaS companies.

Well-organized FAQ with clear categories. Answers are concise and include links to detailed docs when needed.

Comprehensive FAQ covering pricing, security, and technical questions. Clear, scannable format.

FAQ organized by topic with search functionality. Answers are developer-friendly and technical.

Accessibility considerations

Ensure your component is usable by everyone.

  • Use proper disclosure widgets: <button> with aria-expanded and aria-controls for accordions.
  • Ensure keyboard navigation works: Enter/Space to toggle, Escape to close.
  • Use semantic HTML: <dl> (definition list) with <dt> (term) and <dd> (definition) for FAQ structure.
  • Ensure sufficient color contrast for FAQ text and expand/collapse indicators.
  • For searchable FAQs, ensure search is keyboard accessible and results are announced.
  • Test with screen readers to ensure questions and answers are properly announced.
  • Provide skip links or clear navigation for users who want to jump between FAQ sections.