Skip to main content

File Upload

Kapa provides an integration that enables uploading single files directly in the platform. This integration offers a quick and simple way to add content to your knowledge base without setting up complex integrations or permissions.

Prerequisites

Data ingested

When you upload files to Kapa, the following data is ingested:

  • Complete text content of the file
  • For OpenAPI files, the complete API structure and documentation
  • For Word documents, formatted text and structure

Supported file formats

The following file types are supported:

FormatFile ExtensionContent Type
Markdown.mdDocumentation, guides, README files
Text.txtPlain text content
OpenAPI.json, .yaml, .ymlAPI specifications
StackOverflow.csvExported Q&A content
Word.docxFormatted documentation

Setup

  1. Go to the Sources tab in the Kapa platform
  2. Click Add new source
  3. Enter a name for your source
  4. Select File Upload as the source type
  5. Click Choose File and select the file from your computer
  6. Click Upload to begin the ingestion process

Best practices

  • Use descriptive filenames: Clear filenames help identify the content when reviewing sources
  • Structure your content: Well-organized documents with headings and sections are easier for Kapa to understand
  • Keep files updated: If your content changes, you'll need to manually re-upload updated files
  • Combine with other sources: File Upload works best as a supplement to more comprehensive data sources

Troubleshooting

  • File not accepted: Verify your file has one of the supported extensions
  • Upload errors: Check that your file isn't corrupted and is under the size limit
  • Formatting issues: Complex formatting in Word documents may not be perfectly preserved