> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brainbox.com.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Files & Boxes
> Upload documents, organize files, and create collections with AI chat
Learn how to manage documents, create organized collections (Boxes), and use tags to keep everything accessible.
## Files: Storage & Management
### Supported File Types
BrainBox supports over 50 file formats, making it versatile for any kind of document work.
**Documents** are fully supported, including PDFs (even scanned ones with OCR), Word documents with complete text extraction, PowerPoint presentations with all slides included, Excel spreadsheets where formulas and data are preserved, and plain text files in various formats.
**Images** get the AI treatment too. JPEG, PNG, and TIFF files are analyzed and text is extracted via OCR, making all image types searchable with visual recognition.
**Audio & Video** files are automatically transcribed using speech-to-text, turning your audio and video content into searchable text. Supported formats include MP3, WAV, M4A, OGG, FLAC, AAC, AC3, and OPUS.
**Data Files** like CSV get automatic data analysis, while JSON and XML files have their data structures preserved for easy querying.
**Code** files are supported too, with full syntax highlighting and searchability for JavaScript, Python, TypeScript, CSS, HTML, and over 20 more programming languages.
For a complete and detailed list of all supported file types with specific requirements and limitations, visit the [Supported File Types Reference](https://app.brainbox.com.co/en/reference/file-types).
### File Limitations
| Limit | Details |
| ------------------- | ----------------------------------------------------- |
| **Max Size** | 1 GB per file |
| **Storage** | Depends on your plan (50 MB - 3 GB) |
| **Upload Count** | Unlimited (until storage full) |
| **Processing Time** | Small (\< 10 MB): 1-2 min; Large (100+ MB): max 8 min |
| **OCR Support** | Scanned PDFs and images automatically OCR'd |
### Uploading Files
Click "Files" section or go to your Box
Look for "Upload Files", "+ Add Files", or drag-drop area
Choose one or multiple files from your computer
Status: "Uploading" → "Processing" → "Indexed"
Once "Indexed", files are searchable and ready for AI chat
Drag and drop files directly into BrainBox for faster uploading. Select multiple files with Ctrl (Cmd on Mac) for batch uploads.
### File Management
**Viewing File Details**
1. Click on a file name
2. See metadata: name, size, type, upload date, status, pages
3. View associated tags
4. Option to download original file
**Searching Files**
1. In Files section, use the search box
2. Type file name or keywords
3. Results filter as you type
4. Click result to view file
**Deleting Files**
Deleting files is permanent. Once deleted, cannot be recovered.
1. Find the file
2. Click three-dot menu or right-click
3. Select "Delete"
4. Confirm deletion
5. Storage space is freed up
**Best Practices**
Use clear, descriptive file names from the start—your future self will thank you. Organize files into relevant Boxes so related documents stay together. Add tags for quick categorization and filtering. Regularly delete old or unnecessary files to keep your workspace clean and stay within quota limits. And please, don't use unclear names like "Document1.pdf" that tell you nothing about the content!
## Boxes: Organized Collections
### What is a Box?
A **Box** is a collection of related files with a dedicated AI chat area. Think of it as a project folder containing all files for one project, a client collection holding everything for a specific client, a topic library organizing files about one subject, or a case dossier with all files related to one case. Boxes make it easy to keep related documents together and have focused conversations about them.
### Why Use Boxes?
Group related files logically by project or topic
Have conversations about specific collections
Share entire collections with one permission set
All team members see same organized structure
### Creating a Box
Click "Boxes" in the left navigation
Look for "Create Box" or "+ New Box" button
Choose files to include (can add more later)
Use descriptive name: "Q4 Marketing" not "Box1"
Click "Create Box" - instantly available
### Managing Boxes
**Viewing Your Boxes**
Click the "Boxes" section and all your boxes appear in a list or grid view. Each box shows its name, file count, creation date, and number of chat conversations.
**Sorting & Filtering**
Sort your boxes by name, recently updated, created date, or most used. Filter them to see just your boxes, boxes shared with you, or all boxes at once.
**Finding a Box**
Use the search box at the top, type the box name, and results filter instantly as you type.
**Opening a Box**
Click the box name to open it. You'll see all files in the box, the chat interface appears, and you can scroll to view previous conversations.
**Renaming a Box**
Click the box name or edit icon, enter the new name, and press Enter to save. Simple as that.
**Deleting a Box**
Deleting a Box does NOT delete the files. Files remain in your Files section and can be added to other boxes.
1. Find box in list
2. Click three-dot menu
3. Select "Delete Box"
4. Confirm deletion
5. Box is removed, files stay safe
### Managing Files Within Boxes
**Adding Files to a Box**
1. Open the Box
2. Click "Add Files" or "+"
3. Select files to add
4. They appear in the box immediately
**Removing Files from a Box**
1. In file list, click the "X" icon
2. Confirm removal
3. File removed from box (not deleted from system)
4. File still accessible from Files section
**Copying Files to Another Box**
1. File menu → "Add to Another Box"
2. Select destination box
3. File now in both boxes
## Tags: Smart Organization
### What are Tags?
**Tags** are labels you create to organize and find files quickly. You might use status tags like "Important", "Review", "Final", or "Draft". Project tags like "Client\_ABC", "Project\_Q4", or "2025\_Budget" help you filter by engagement. Security tags such as "Confidential", "Public", or "Internal" indicate access levels.
### Creating Tags
Click workspace name → "Settings"
Look for "Tags" or "Labels"
Click "Create Tag" or "+"
Use clear, consistent names
Pick a color for visual identification
Tag is now available to use
### Applying Tags
**To Single Files**
1. Click file details
2. Find "Tags" section
3. Click "Add Tag"
4. Select tag from list
5. Tag appears on file
**To Multiple Files**
1. Select multiple files (checkboxes)
2. Click "Add Tags" button
3. Select one or more tags
4. Tags applied to all selected files
### Using Tags to Filter
1. In file list, see tag filter options
2. Click tag to filter
3. Only files with that tag appear
4. Select multiple tags to combine filters
5. Can use AND or OR logic
### Managing Tags
| Action | How |
| ---------- | ----------------------------------------------- |
| **Edit** | Click tag → Edit name/color/description |
| **Delete** | Click tag → Delete (removes tag from all files) |
Tags can be edited or deleted. Once a tag is deleted, it's removed from all files that had it.
### Best Practices for Tags
**Use Consistent Naming** by sticking to a pattern. "Client\_ABC" and "Client\_XYZ" work great together. Mixing "Client ABC", "ClientABC", and "ABC" creates confusion and defeats the purpose.
**Choose Meaningful Colors** that make sense at a glance. Red signals urgent or important items, green indicates approved or final versions, yellow marks things pending review, and blue can denote internal or reference materials.
**Keep Tag Counts Reasonable** with around 10-20 tags across your workspace. Having 100+ tags becomes too hard to manage and you'll spend more time choosing tags than actually working.
**Combine with Boxes** strategically. Use boxes for major organization (like separating clients or projects) and tags for detailed categorization within those boxes (like status, priority, or document type).
## File Organization Strategy
### Recommended Structure
```
Workspace: "Company Name"
├── Box: "Client Projects"
│ ├── Files tagged: "Client_A", "Q4", "Active"
│ ├── Files tagged: "Client_B", "Q3", "Archived"
│
├── Box: "Internal Operations"
│ ├── Files tagged: "Finance", "Budget", "2025"
│ ├── Files tagged: "HR", "Policies", "Current"
│
├── Box: "Research & Reference"
│ ├── Files tagged: "Industry_Analysis", "Research"
│ ├── Files tagged: "Competitor_Research", "2024"
```
### Planning Your Organization
Before uploading files, take a moment to plan your organization. Ask yourself: How many Boxes do you need? Usually 3-5 main ones is plenty. What files go in each? Organize by project, client, document type, or team. What tags will help? Consider status, urgency, confidentiality, and date tags. Who needs access? Remember that individual boxes can have different permissions.
### Tips
Create Boxes before uploading lots of files—it's easier to organize as you go than to sort through hundreds of files later. Tag files as you upload them while the context is fresh. Use consistent naming conventions so everyone on your team understands the system. Archive old boxes instead of deleting them so you maintain history. Review your organization quarterly to make sure it still makes sense as your work evolves.
***
Ready to get organized? Start [uploading files](#uploading-files) or [create your first Box](#creating-a-box). Learn about [AI chat and search](/en/ai-chat-search) next.