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

# Adding Documents

> Upload files, scrape websites, or paste text to build your knowledge base.

## Adding content to your knowledge base

There are three ways to add content to a knowledge base:

## Upload files

Upload documents directly from your computer.

**Supported formats:**

* Documents: PDF, DOC, DOCX, TXT, MD, RTF
* Spreadsheets: CSV, XLS, XLSX
* Presentations: PPTX
* Data: JSON
* Web: HTML, HTM

**Size limits:**

* PDF files: Up to **100 MB**
* All other formats: Up to **10 MB**

<Steps>
  <Step title="Click Add Document">
    Select the **Upload Files** option.
  </Step>

  <Step title="Select your file">
    Browse and select the file you want to upload.
  </Step>

  <Step title="Wait for processing">
    The document will show a **Processing** status while Sonara indexes the content. Once complete, the status changes to **Completed**.
  </Step>
</Steps>

## Scrape web pages

Index content from any public website.

<Steps>
  <Step title="Click Add Document">
    Select the **Web Pages** option.
  </Step>

  <Step title="Enter the URL">
    Provide the website URL you want to scrape. Optionally add a custom name for the document.
  </Step>

  <Step title="Configure crawl settings">
    * **Crawl depth** (1-10)  - How many levels of links to follow from the starting page
    * **Max pages** (1-100)  - Maximum number of pages to scrape
  </Step>

  <Step title="Submit">
    Click **Add** to start the crawl. The document will show as **Processing** until complete.
  </Step>
</Steps>

<Tip>
  Start with a crawl depth of 1-2 and 10-20 max pages. You can always add more pages later.
</Tip>

## Paste text

Directly paste text content into the knowledge base.

<Steps>
  <Step title="Click Add Document">
    Select the **Text Content** option.
  </Step>

  <Step title="Enter content">
    * **Name** (optional)  - A label for this text document
    * **Content**  - Paste your text directly
  </Step>

  <Step title="Submit">
    Click **Add** to process the text.
  </Step>
</Steps>

## Document status

Each document shows a processing status:

| Status         | Meaning                                                              |
| -------------- | -------------------------------------------------------------------- |
| **Completed**  | Document is indexed and ready for use                                |
| **Processing** | Document is being processed (usually takes a few seconds to minutes) |
| **Pending**    | Document is queued for processing                                    |
| **Failed**     | Processing failed  - click **Retry** to try again                    |

## Managing documents

* **Retry**  - For failed web scrapes, click retry to re-crawl the URL
* **Delete**  - Remove a document from the knowledge base permanently