FAQ Management

FAQs (Frequently Asked Questions) are the most direct way to train your chatbot. Add common questions and their answers to ensure accurate, consistent responses.

Overview

The FAQ system in ChatReact includes:

• Manual FAQ creation
• AI-generated FAQ suggestions (on demand via button or Improvement Agent)
• Category organization
• Translations into all 24 EU languages
• Publishing controls
• An embeddable FAQ widget for your website

Creating FAQs

Manual Creation

1. Navigate to FAQs in the sidebar
2. Click Add FAQ
3. Fill in the details:

1. Click Create FAQ

New FAQs are published immediately. To take one offline, click Save as Draft on its card — Publish makes it live again.

Answer Formatting

Answers are edited using a WYSIWYG rich-text editor with the following formatting options:

• Bold and italic text
• Bullet lists and numbered lists
• Links (displayed as clickable links in the widget)
• Line breaks and paragraphs

Categories

Creating Categories

1. Go to FAQs → Categories tab
2. Click Add Category
3. Enter a category name and optional description
4. Save

Suggested Categories

Common categories include:

• Pricing & Billing
• Account Management
• Technical Support
• Shipping & Returns
• Getting Started
• Features & Capabilities

Organizing FAQs

• Assign a category using the dropdown on each FAQ card
• Filter by category in the list view
• Categories appear in the FAQ widget as tabs

Sort Order

Control how FAQs are displayed in the embedded widget. Configure this in FAQs → Settings → Behavior:

When Custom is selected, the Published and Drafts tabs show a drag handle and a numeric order input on each FAQ card. Drag cards to reorder, or enter a number to move a FAQ to a specific position.

Per-Category Sort Order

Each category can have its own independent sort mode. Configure this in the Categories tab:

• The "All" tab in the widget uses the global sort mode from Widget Settings
• Individual category tabs use their own sort mode
• This allows different ordering strategies per category (e.g., alphabetical for "General" but custom for "Pricing")

FAQ Suggestions

FAQ suggestions are generated on demand (not automatically from chat):

1. Generate from Knowledge Base – Use the button on the FAQ Suggestions page to create suggestions from your crawled website content.
2. Improvement Agent – The agent can suggest new or updated FAQs as part of its improvement proposals.
3. Manual – Create FAQs yourself at any time.

Generate from Knowledge Base

You can generate FAQ suggestions from your crawled website content:

1. Go to FAQs → Suggestions tab
2. Click Generate from Knowledge Base
3. Optional: Select a category for targeted generation
4. Wait for AI analysis to complete
5. Review the generated suggestions

Intelligent Gap Analysis

When you don't select a category, ChatReact uses intelligent gap analysis:

• The AI analyzes your existing FAQs and knowledge base
• Automatically detects which topics are already well covered
• Generates FAQs only for topics that are insufficiently covered (0-1 FAQs)
• Prioritizes important business topics: pricing, services, requirements, processes

Category-Based Generation

When you select a category, the AI uses semantic search:

• Searches the knowledge base specifically for information related to the chosen category
• Extracts relevant content (up to 1500 words)
• Generates FAQs specifically for that category

Automatic Category Assignment

If you have FAQ categories set up, the AI will automatically suggest the most appropriate category for each generated FAQ. This saves time when organizing your FAQs.

Reviewing Suggestions

1. Go to FAQs → Suggestions tab
2. Review each suggestion:
   • See the confidence score and the AI-suggested category (if categories exist)
   • Edit the question and answer as needed — the edit dialog's Approve & Publish button publishes your edited version
3. Click Approve to add the suggestion to your FAQs or Reject to dismiss it

Publishing

Draft vs Published

Changing Publish Status

Each FAQ card has its own controls: click Save as Draft to take a published FAQ offline, or Publish to make a draft live.

FAQ Widget

Display FAQs on your website as a standalone component:

Embedding

<div id="chatreact-faq"></div>
<script 
  src="https://www.chatreact.ai/embed/faq-widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID"
  async
></script>

You can find the ready-to-copy embed code in FAQs → Embed tab.

Showing Only Specific Categories

Add the optional data-categories attribute to display only FAQs from specific categories, using category slugs separated by commas:

<script 
  src="https://www.chatreact.ai/embed/faq-widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID"
  data-categories="slug1,slug2"
  async
></script>

Without this attribute, all published FAQs are shown — with category tabs when you have more than one category. Your available category slugs are listed in the Embed tab.

WordPress

With the ChatReact WordPress plugin installed, you can embed the FAQ widget natively:

• Shortcode: [chatreact_faq id="YOUR_CHATBOT_ID"]
• Shortcode with category filter: [chatreact_faq id="YOUR_CHATBOT_ID" categories="slug1"]
• Gutenberg block: search for "ChatReact FAQ" in the block inserter

The Embed tab provides ready-to-copy shortcodes and a plugin download link. See WordPress → for plugin setup.

Shopify

Add the FAQ widget to your Shopify store via the Theme Editor (recommended):

1. Install the ChatReact app from the Shopify App Store
2. Open your Shopify Theme Editor (Online Store → Customize)
3. Click Add section or Add block and search for "ChatReact FAQ"
4. Enter your Chatbot ID and configure categories and language

Alternatively, paste the embed code into a Custom Liquid section in your theme. See Shopify → for details.

Widget Features

• Accordion-style expandable questions
• Category tabs (shown when you have more than one category)
• SEO-friendly: FAQs are rendered in a search-engine friendly format with FAQPage structured data for rich snippets
• Matches your brand colors
• Configurable width (100% or custom pixel width 400–1200px)
• Configurable sort order (Date, Name, or Custom per category)

Widget Settings

Customize the widget's appearance and behavior in FAQs → Settings:

Translations

Translating FAQs

ChatReact supports translating your FAQs into all 24 EU languages:

1. Go to FAQs → Translations tab
2. Pick a FAQ from the Select FAQ... dropdown
3. Switch to a target language tab
4. Edit translations manually, or use Translate this FAQ to translate a single FAQ with AI

Bulk Translation

Translate all FAQs at once using the Translate All button:

• Translations run as a background job on the server — you can leave the page or close your browser
• Progress is saved and displayed when you return
• A notification appears in the bell icon when all translations are complete
• Use the Cancel button to stop the process at any time
• Translations are saved immediately as each FAQ is processed

Search & Filter

Finding FAQs

Use the search bar to find FAQs by:

• Question text
• Answer content
• Category name

Filtering & Sorting

• By Status: Switch between the Published and Drafts tabs
• By Category: Filter the list with the category selector
• Sorting: Order FAQs by Date, Name, or Category with an ascending/descending toggle — or choose Custom for manual ordering

Best Practices

1. Start with top 20: Begin with your most common questions
2. Be specific: "How do I cancel?" vs "How do I cancel my monthly subscription?"
3. Keep answers helpful: Include next steps or links when relevant
4. Review regularly: Check which questions are being asked but not answered
5. Use categories: Organization helps both you and visitors
6. Monitor suggestions: AI suggestions reveal knowledge gaps

Next Steps

• Knowledge Base →
• Analytics →
• Improvement Agent →