Documentation

Home FAQs

The Home FAQs page lets you manage frequently asked questions that are synced to your AI agent's knowledge base. If you find that your AI agent's responses are incomplete or unsatisfactory, you can add or refine FAQs here to provide better, more accurate information — giving the AI the context it needs to improve its answers.

Access it from Admin > Home FAQs in your admin panel.

Overview

FAQs you add here are automatically synced to your AI agent's knowledge base, allowing the AI to answer FAQ-related questions accurately. When you create, edit, or delete a FAQ, the corresponding knowledge base entry is updated automatically.

Managing FAQs

Adding a FAQ

  1. Click Add FAQ
  2. Enter the Question and Answer
  3. Toggle Active to control visibility
  4. Click Create

The FAQ is immediately added to both the landing page and the knowledge base.

Editing a FAQ

Click the question text or the edit icon to open the edit dialog. Changes to the question or answer automatically update the knowledge base entry.

Deleting a FAQ

Click the delete icon and confirm. The FAQ and its knowledge base entry are both removed.

Reordering

Use the up/down arrows to change the display order on the landing page.

Active/Inactive Toggle

Toggle a FAQ's visibility without deleting it. Inactive FAQs are hidden from the landing page and excluded from the knowledge base.

Syncing the Knowledge Base

Click Sync Knowledge Base to re-sync all active FAQs at once. This is useful when:

  • FAQs were added before the knowledge base sync feature was enabled
  • You want to verify all FAQs are properly indexed
  • You suspect some entries may be out of sync

The sync reports how many FAQs were created, updated, deleted, or unchanged.

Writing Effective FAQs

Well-written FAQs improve both the visitor experience and the AI agent's ability to answer questions.

Example: Before and After

Poor FAQ:

Q: Shipping?

A: 5-7 days.

Improved FAQ:

Q: How long does shipping take?

A: Standard shipping typically takes 5-7 business days within the continental US. Expedited options are available for 2-3 business day delivery.

The improved version gives the AI enough context to answer variations like "Do you offer fast shipping?" or "When will my order arrive?"

Examples That Improve AI Answers

Product-specific FAQ:

Q: How do I choose the right snowboard size?

A: Board size depends on your weight, height, and riding style. The board should reach between your chin and nose when standing upright. Freestyle riders may prefer shorter boards for maneuverability, while powder riders may want longer ones for better float.

This lets the AI answer "What size snowboard do I need?" and "I'm 5'10", what board length should I get?"

Policy FAQ:

Q: Can I return or exchange a product?

A: We offer a 30-day return policy on all unused products in their original packaging. Exchanges for different sizes or colors are available at no extra cost. To start a return, visit your order history or contact our support team.

This lets the AI answer "What's your return policy?", "Can I swap for a different size?", and "How do I return something?"

Service FAQ:

Q: What is included with a ski wax subscription?

A: The subscription delivers premium wax directly to your door on a customizable schedule — monthly, bi-monthly, or quarterly. Each shipment includes enough wax to keep your board or skis performing at their best. You can pause or cancel anytime from your account.

This lets the AI answer "Tell me about the wax subscription", "Can I cancel my subscription?", and "How often do I get wax delivered?"

Tips

  1. Use natural question phrasing — Write questions the way a customer would actually ask them
  2. Include key details in answers — Mention specifics like timeframes, prices, and conditions
  3. Cover variations — A single well-written FAQ can handle many related questions
  4. Keep answers concise but complete — 2-4 sentences is usually ideal
  5. Avoid jargon — Use language your customers understand

Related Pages