> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bubblav.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge Overview

> How your chatbot learns and uses knowledge to answer questions

The Knowledge Base is your chatbot's brain. It stores all the information the AI uses to answer customer questions accurately and helpfully.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/bubblav-e553cf80/nhelQxnCmiOq_LRR/images/knowledge-base.png?fit=max&auto=format&n=nhelQxnCmiOq_LRR&q=85&s=2cd5b14fc8a00d2e6d9f458acee32ca7" alt="Knowledge Base Overview" width="1067" height="383" data-path="images/knowledge-base.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/bubblav-e553cf80/nhelQxnCmiOq_LRR/images/knowledge-base-dark.png?fit=max&auto=format&n=nhelQxnCmiOq_LRR&q=85&s=b44059eb3c45b15e108d600c6eb00155" alt="Knowledge Base Overview" width="1055" height="378" data-path="images/knowledge-base-dark.png" />
</Frame>

## How It Works

<Steps>
  <Step title="Ingestion">
    You provide content via website crawling, file uploads, Q\&A entries, or sitemaps
  </Step>

  <Step title="Processing">
    Content is broken into chunks, analyzed, and converted to embeddings for semantic search
  </Step>

  <Step title="Retrieval">
    When a customer asks a question, the AI finds the most relevant knowledge chunks
  </Step>

  <Step title="Generation">
    The AI uses those chunks to formulate natural, accurate, contextual answers
  </Step>
</Steps>

***

## Knowledge Sources

BubblaV supports six types of knowledge sources:

<CardGroup cols={2}>
  <Card title="Websites" icon="globe" href="/user-guide/knowledge/website-crawling">
    Manage your main website, sub-domains, sitemaps, and llms-full.txt files
  </Card>

  <Card title="Pages" icon="file" href="/user-guide/knowledge/website-crawling">
    Add specific URLs to crawl
  </Card>

  <Card title="Files" icon="folder" href="/user-guide/knowledge/files">
    Upload PDFs, Word docs, text files, and Markdown
  </Card>

  <Card title="Q&A" icon="type" href="/user-guide/knowledge/q-a">
    Manually add specific question and answer pairs
  </Card>

  <Card title="Insights" icon="chart-line" href="/user-guide/knowledge/content-gaps">
    Identify content gaps and review answerable questions
  </Card>

  <Card title="Internal Tickets" icon="ticket" href="/user-guide/knowledge/tickets">
    Train your AI with your resolved support tickets
  </Card>
</CardGroup>

***

## Plan Limits

Your subscription plan determines how much knowledge you can add:

| Plan      | Max Pages    | File Upload Size | Data Sync |
| --------- | ------------ | ---------------- | --------- |
| **Free**  | 50 pages     | 10 MB per file   | Manual    |
| **Pro**   | 5,000 pages  | 10 MB per file   | Weekly    |
| **Turbo** | 50,000 pages | 10 MB per file   | Weekly    |

<Note>
  Page count includes all sources: crawled pages, uploaded files, and Q\&A entries.
</Note>

***

## Quick Start

The fastest way to train your chatbot:

<Steps>
  <Step title="Add Your Main Website">
    When you create a new website in your dashboard, you'll be prompted to enter your main website URL. The crawling process starts automatically after you add the website.

    **To add a main website later:**

    1. Go to **Knowledge** → **Websites**
    2. Enter your website URL (e.g., `https://example.com`)
    3. Click **Add** - crawling begins automatically
  </Step>

  <Step title="Add Sub-websites & Sitemaps (Optional)">
    The **Websites** tab also lets you manage sitemaps and llms-full.txt files alongside your websites.

    **Sub-websites** are additional domains to include in your knowledge base (e.g., `https://blog.example.com`).

    **Sitemaps & LLMs** lets you add sitemap.xml or llms-full.txt URLs for faster crawling.

    To add either:

    1. Go to **Knowledge** → **Websites**
    2. Use the **Add Website** or **Add URL** button in the appropriate section
  </Step>

  <Step title="Wait for Crawling">
    The crawling process runs automatically in the background. You can monitor progress in the **Knowledge** → **Pages** section. No manual start button is needed.
  </Step>

  <Step title="Review Pages">
    Once crawling completes, check the crawled pages list and disable any you don't want included in your knowledge base
  </Step>

  <Step title="Test Your Bot">
    Ask questions to verify the bot answers correctly using your newly added content
  </Step>
</Steps>

***

## Best Practices

<AccordionGroup>
  <Accordion title="Keep knowledge updated">
    Re-crawl your website after making content changes. Pro/Turbo plans have automatic weekly syncs.
  </Accordion>

  <Accordion title="Be specific and factual">
    Clear, concise content works best. Avoid vague language or marketing fluff.
  </Accordion>

  <Accordion title="Remove irrelevant pages">
    Disable login pages, privacy policies, or other pages that shouldn't influence answers.
  </Accordion>

  <Accordion title="Add custom Q&As">
    Use the Q\&A section for frequently asked questions that aren't on your website.
  </Accordion>

  <Accordion title="Close content gaps">
    The AI identifies what it can't answer. Add Q\&A for unanswered questions to improve accuracy.
  </Accordion>
</AccordionGroup>

***

## What Makes Good Knowledge?

✅ **Good for chatbots:**

* Product descriptions and specifications
* FAQ pages with clear answers
* How-to guides and tutorials
* Shipping and return policies
* Contact and support information

❌ **Not ideal:**

* Login/registration pages
* Cart and checkout pages
* Dynamic content that changes frequently
* Image-only pages without text
* Duplicate content across multiple pages

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Website Crawling" icon="globe" href="/user-guide/knowledge/website-crawling">
    Learn how to crawl your website
  </Card>

  <Card title="Q&A" icon="type" href="/user-guide/knowledge/q-a">
    Manually add question and answer pairs
  </Card>

  <Card title="Content Gaps" icon="sparkles" href="/user-guide/knowledge/content-gaps">
    Identify and fix missing knowledge
  </Card>

  <Card title="Test Your Bot" icon="comment" href="/user-guide/testing">
    Verify your chatbot works correctly
  </Card>
</CardGroup>
