Skip to main content
Once a knowledge base is created, its data source cannot be changed later.
When creating a knowledge base, you can upload local files as its data source:
  1. Click Knowledge > Create Knowledge.
  2. Select Import from file as the data source, then upload your files.
    • Maximum number of files per upload: 5
    • Maximum file size: 15 MB
    For self-hosted deployments, you can adjust these two limits via the environment variables UPLOAD_FILE_SIZE_LIMIT and UPLOAD_FILE_BATCH_LIMIT.

For Images in Uploaded Files JPG, JPEG, PNG, and GIF images under 2 MB are automatically extracted as attachments to their corresponding chunks. These images can be managed independently and are returned alongside their chunks during retrieval. URLs of extracted images remain in the chunk text, but you can safely remove these URLs to keep the text clean—this won’t affect the extracted images. If you select a multimodal embedding model (marked with a Vision icon) in index settings, the extracted images will also be embedded and indexed for retrieval. Each chunk supports up to 10 image attachments; images beyond this limit will not be extracted.
For self-hosted deployments, you can adjust the following limits via environment variables:
  • Maximum image size: ATTACHMENT_IMAGE_FILE_SIZE_LIMIT
  • Maximum number of attachments per chunk: SINGLE_CHUNK_ATTACHMENT_LIMIT
The above extraction rule applies to:
  • Images embedded in DOCX files
    Images embedded in other file types (e.g., PDF) can be extracted by using appropriate document extraction plugins in knowledge pipelines.
  • Images referenced via accessible URLs using the following Markdown syntax in any file type:
    • ![alt text](image_url)
    • ![alt text](image_url "optional title")