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

# Managing Your Knowledge Base

> Learn how to add, update, and organise the content that powers your assistant's answers.

## Your assistant knows what you teach it

Your assistant doesn't come with pre-loaded answers. It learns from the content you provide, your documents, your website pages, your guides, and your policies.

The **Knowledge Base** is where all of that content lives. The better your knowledge base, the better your assistant's answers.

This page explains how to build and maintain it.

<Frame caption="The Knowledge Base tab in your dashboard — where all your uploaded content is stored and managed">
  <img src="https://mintcdn.com/droogtechnologies-496fe651/bQaATnUQ0lYXPRwd/images/KB.png?fit=max&auto=format&n=bQaATnUQ0lYXPRwd&q=85&s=d259055dd0837ed5778487fc3aa81746" alt="Kb1" width="1134" height="402" data-path="images/KB.png" />
</Frame>

## What you can upload

Droog accepts a wide range of content types. You can mix and match; most organisations use a combination.

<CardGroup cols={3}>
  <Card icon="file-pdf" title="PDF Files">
    Product guides, brochures, policy documents
  </Card>

  <Card icon="file-word" title="Word Documents">
    Internal handbooks, process documents, FAQs
  </Card>

  <Card icon="file-lines" title="Text & Markdown Files">
    Plain text content, release notes, support articles
  </Card>

  <Card icon="globe" title="Website URLs">
    Paste any public webpage, Droog reads and indexes it automatically
  </Card>

  <Card icon="sitemap" title="Sitemaps">
    Add an entire website at once by submitting its sitemap link
  </Card>
</CardGroup>

<Info>
  When importing content from websites or external sources, ensure you have the right to use that content. Always follow applicable copyright and data usage guidelines.
</Info>

## How to add content

### Upload a file

1. Go to your assistant's **Knowledge** tab from the dashboard
2. Click **Upload**
3. Select the file from your computer
4. Wait for the status to show `Completed`  and `Active`

<Frame caption="Uploading a document — drag and drop or browse to select files from your computer">
  <img src="https://mintcdn.com/droogtechnologies-496fe651/lLm-ebGtqWJt076z/images/upload_KB.png?fit=max&auto=format&n=lLm-ebGtqWJt076z&q=85&s=16096b46a54ed71da012b7e360f27c9f" alt="Upload KB" width="1000" height="244" data-path="images/upload_KB.png" />
</Frame>

### Add a website URL

1. Click **Scrape via Sitemap**
2. Paste the full web address (e.g. `https://yourwebsite.com/faqs`)
3. Droog will visit the page, read its content, and add it to your knowledge base

### Add an entire website via sitemap

1. Click **Scrape via Sitemap**
2. Paste your sitemap URL (e.g. `https://yourwebsite.com/sitemap.xml`) or (e.g. `https://yourwebsite.com`)
3. Droog will index all the pages listed in the sitemap automatically. You can select individual or multiple pages and add them to your knowledge base

<Frame caption="Uploading a web URL — enter a specific URL page or the sitemap">
  <img src="https://mintcdn.com/droogtechnologies-496fe651/lLm-ebGtqWJt076z/images/scrape.png?fit=max&auto=format&n=lLm-ebGtqWJt076z&q=85&s=6fd9ea921ea0e19c56968ea9f9481403" alt="Upload scrape" width="1000" height="745" data-path="images/scrape.png" />
</Frame>

<Warning>
  Always wait for documents to show a `Active` status before testing your assistant. If you test while content is still processing, answers may be incomplete or inaccurate.
</Warning>

## Understanding document status

After uploading, each document goes through a short processing stage. Here's what each status means:

| Status             | What it means                                                                   |
| ------------------ | ------------------------------------------------------------------------------- |
| `Processing`       | Droog is reading and preparing your content — this usually takes under a minute |
| `Completed/Active` | Content is ready, and your assistant can now use it to answer questions         |
| `Failed`           | Something went wrong — check the file format and try uploading again            |

<Tip>
  If a document repeatedly shows `Failed`Try exporting it as a plain PDF and uploading that version instead. Complex formatting in Word documents can occasionally cause issues.
</Tip>

## Updating your content

Your knowledge base is not set-and-forget. Keeping it up to date is the single most important thing you can do to keep your assistant accurate.

### When to update

* Your **pricing or plans** have changed
* You launch a **new product or feature**
* Your **policies or processes** are updated
* A document contains **outdated information**

### How to update

You have two options:

**Replace a document** — Delete the old version and upload the new one. Your assistant will immediately use the updated content.

**Edit a URL source** — If you added a webpage, you can schedule a frequency to re-scrape it at any time to pull in the latest version of that page. `In progress`

<Frame caption="Managing existing documents — delete outdated files or re-sync URLs directly from the Knowledge tab">
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/droogtechnologies-496fe651/images/knowledge-management-actions.png" alt="Knowledge Management Actions — showing a document list with delete and re-sync buttons on each row" />
</Frame>

## Removing content

If a document is outdated or no longer relevant, remove it.

1. Find the document in your **Knowledge** tab
2. Click the **delete icon** next to it (You can also multi-select items for deletion)
3. Confirm deletion

<Warning>
  Deleting a document removes it from your assistant's knowledge immediately. If the document contained answers to common questions, your assistant will no longer be able to answer those questions until you upload updated content.
</Warning>

## Tips for a great knowledge base

<CardGroup cols={2}>
  <Card icon="bullseye" title="Be specific">
    Upload content that directly answers the questions your users actually ask. Broad, general documents are less useful than targeted, specific ones.
  </Card>

  <Card icon="rotate" title="Keep it fresh">
    Review your knowledge base once a month. Remove anything outdated and add any new content your users might need.
  </Card>

  <Card icon="file-circle-check" title="Use clean, readable files">
    Well-formatted documents produce better answers. Avoid scanned images of text — Droog reads text content, not images within PDFs.
  </Card>

  <Card icon="flask" title="Test after every update">
    After adding or removing content, spend a few minutes testing your assistant to make sure it's responding correctly.
  </Card>
</CardGroup>

***

## What's next?

<CardGroup cols={2}>
  <Card icon="flask" href="/guides/testing" title="Test your assistant">
    After updating your knowledge base, test your assistant to check its responses.
  </Card>

  <Card icon="sliders" href="/guides/customising" title="Customise behaviour">
    Control how your assistant responds when it can't find an answer.
  </Card>
</CardGroup>

<Note>
  **Have a question?** Reach us at [contact@droog.io](mailto:hi@droog.io)
</Note>
