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

# Uploading Documents

> Upload PDF, DOCX, Markdown, JSON, XLSX, and HTML files to Noorle knowledge bases with automatic chunking, vector embedding, and metadata tagging

Upload documents to make them searchable in your knowledge base.

## Supported Formats

* **PDF** - Most common
* **DOCX** - Word documents
* **TXT** - Plain text
* **Markdown** - Formatted text
* **JSON** - Structured data
* **XLSX** - Spreadsheets
* **HTML** - Web pages

## Upload Steps

<Steps>
  <Step title="Open Knowledge Base">
    **Knowledge** > Select knowledge base
  </Step>

  <Step title="Upload Documents">
    Click **Upload Documents** button
  </Step>

  <Step title="Select Files">
    * Drag and drop, or
    * Click to browse
    * Select one or more files
  </Step>

  <Step title="Set Metadata (Optional)">
    * Document title
    * Category/tags
    * Source URL
    * Date
  </Step>

  <Step title="Process">
    Click **Upload**

    * Documents chunked
    * Embedded
    * Indexed (takes minutes for large docs)
  </Step>

  <Step title="View Status">
    Track upload progress in **Documents** tab
  </Step>
</Steps>

## Document Processing

Each document:

1. **Parse** - Extract text from format
2. **Chunk** - Split into \~1KB sections
3. **Embed** - Convert to vectors
4. **Index** - Store in vector DB
5. **Ready** - Available for search

Processing time:

* Small docs: seconds
* Large docs: minutes
* Batch uploads: hours

## Chunking Strategy

Documents split intelligently:

* Respect paragraph boundaries
* Keep context together
* Default: \~1KB per chunk
* Overlap: 10% between chunks

Manual configuration available.

## Metadata

Optional info attached to documents:

```
Title: "Product Guide"
Category: "Help"
Tags: ["documentation", "products"]
Source: "https://example.com/guide.pdf"
Date: "2025-03-20"
```

Used for:

* Search filtering
* Result ranking
* Citation tracking

## Updating Documents

To update a document:

1. Delete old version
2. Upload new version
3. New version indexed

Or:

1. Upload new version
2. Old version auto-deleted
3. New version indexed

## Organizing Documents

Use metadata to organize:

| Metadata     | Purpose                    |
| ------------ | -------------------------- |
| **Category** | Product, FAQ, Policy, etc. |
| **Tags**     | Multiple labels            |
| **Source**   | Where doc came from        |
| **Date**     | Version date               |

## Search Filtering

Filter search results by metadata:

```
Category: "FAQ"
Tags: "billing"
→ Only FAQ docs about billing
```

## Deleting Documents

Remove document from knowledge base:

1. **Documents** tab
2. Select document
3. Click **Delete**
4. Confirm

Document removed from search results immediately.

## Bulk Upload

Upload multiple documents:

1. Create ZIP file with documents
2. Upload ZIP
3. Noorle extracts and processes all

Useful for migrating documentation.

## File Size Limits

* **Per file**: 100MB
* **Per batch**: 1GB
* **Total account**: 500GB (limit)

## Processing Errors

Common errors and solutions:

| Error              | Solution                  |
| ------------------ | ------------------------- |
| Unsupported format | Convert to PDF first      |
| Corrupted file     | Re-download and try again |
| Encoding issue     | Save as UTF-8             |
| Too large          | Split into multiple files |
| Password protected | Remove protection first   |

## Testing Search

After upload, test search works:

1. Click **Test Search**
2. Enter query
3. Verify documents appear
4. Check relevance

## Next Steps

* [Vector Search](/docs/run/knowledge/vector-search)
* [Reranking](/docs/run/knowledge/reranking)
* [Knowledge Base Overview](/docs/run/knowledge/overview)