Upload Documents
Open a collection and use Upload to add files from your computer, import web pages, or connect to S3-compatible storage. You need permission to add documents to the collection.
Supported Files and Limits
The collection's file picker accepts these document formats:
| Format | Extensions |
|---|---|
.pdf | |
| Microsoft Office | .docx, .xlsx, .pptx |
| Text and Markdown | .txt, .md |
| HTML | .html |
Choose text-based files. The collection upload interface currently does not support scanned or image-only documents.
For local uploads, select one file at a time, up to 100 MiB per file (shown as 100 MB in the interface). These limits apply to collection uploads; Playground attachments have their own limits.
Upload from Your Computer
- Open the collection and select Upload → upload document.
- Select Choose File and choose a supported file.
- Enter a Document Title that will be easy to recognize when selecting sources.
- Optionally add Author, Year, and Tags. Press Enter or comma to add a tag.
- Select Upload.
- Refresh the document list and check the status. An upload success message confirms receipt; wait for Complete before using the document as a source.
Import from the Web
- Open the collection and select Upload → upload from web.
- Choose Single URL (with crawling) or Multiple URLs under Import Type.
- Enter the starting URL. For multiple URLs, use Add URL to add each address.
- Review the crawl settings below.
- Select Start Import and follow the Document Import Progress dialog.
| Setting | How to use it |
|---|---|
| Crawl Level | Controls how deeply to follow links, from 1 to 5. Start with the default of 1 for a small import. |
| Max Links | Limits the links followed for a single starting URL. |
| Max Links per URL | Sets the limit for each starting URL in a multiple-URL import. |
| Restrict to same domain (recommended) | Keeps crawling within the starting website. Enabled initially. |
Use a small link limit for your first import, then check the resulting documents. A URL must be accessible to Bunyan; entering an address does not sign Bunyan into a website that requires your browser session.
Import from S3-Compatible Storage
-
Open the collection and select Upload → upload from external source.
-
Choose Amazon S3 / Compatible Storage as the Source Type.
-
Enter the storage connection details:
Field What to enter Endpoint URL The endpoint for your storage service. Bucket Name The bucket containing the documents. Prefix (folder path) The path containing the files you want to import. Access Key and Secret Key Storage credentials with access to the selected files. Region The region used by your storage service. -
Select Start Import.
-
Review the progress and any failed-file count, then refresh the collection's document list.
Confirm the bucket and prefix before starting so the import covers the intended files. Ask the person managing your storage for the connection details if needed.
After Upload or Import
Web and storage imports continue in the background if you close the progress dialog. Return to the collection and select Refresh documents to check individual documents.
See Document Processing for status meanings and troubleshooting. Once your documents are complete, select them in the Playground.