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

# Knowledge upload limits

> File size limits for the Knowledge API, how uploads are handled, and strategies for working with large documents.

When uploading files to Knowledge using `POST /v1/knowledge` or `PATCH /v1/knowledge/{id}`, each file must stay within your plan’s **per-file size limit**.

These limits help ensure consistent processing performance, reliable uploads, and fair usage across all users.

## Per-file upload size by plan

Your upload limit depends on your current subscription plan.

| Plan       | Per-file limit |
| ---------- | -------------- |
| Free       | 5 MB           |
| Pro        | 300 MB         |
| Enterprise | 300 MB         |

Limits apply **per file**, not per request. If you upload multiple files at once, each file must individually meet the size requirement.

If you need to upload larger files, consider upgrading your plan or contacting support.

## What happens if a file is too large?

If a file exceeds your plan’s limit, the API will return a **413 — `payload_too_large`** error.

This means the file could not be processed because it exceeds the maximum allowed size.

## Supported formats

Knowledge supports a variety of file types, including PDFs, Office documents, CSVs, images, and more.

For a complete list, see [Create knowledge](/api-reference/knowledge/create-knowledge).

## Working with large documents

If your content exceeds the upload limit, here are some effective approaches:

* **Split large files**\
  Break documents into smaller sections so each file fits within the limit. This is the most reliable solution.

* **Compress files when possible**\
  Reducing file size (especially for images or PDFs) can help you stay within limits without losing important content.

* **Upgrade your plan**\
  Higher-tier plans support significantly larger file uploads. Reach out to our support team to request a subscription upgrade: [support@datagrid.com](mailto:support@datagrid.com)

## Related limits

For request-level limits such as API rate limiting, see [Rate limits](/api-reference/rate-limits).
