Upload & Organization
Learn how to efficiently upload and organize your visual content in CoreViz
Upload & Organization
CoreViz makes it easy to upload and organize large amounts of visual content. This guide covers everything you need to know about getting your images and videos into CoreViz and keeping them organized.
Getting Started with Uploads
Prerequisites
Before uploading content, you'll need:
- A CoreViz account (sign up at lab.coreviz.io)
- An organization set up
- At least one dataset created
Supported File Formats
CoreViz supports a wide range of image and video formats:
Image Formats:
- JPEG (.jpg, .jpeg)
- PNG (.png)
- GIF (.gif)
- WebP (.webp)
- TIFF (.tiff, .tif)
- BMP (.bmp)
- SVG (.svg)
Video Formats:
- MP4 (.mp4)
- MOV (.mov)
- AVI (.avi)
- MKV (.mkv)
- WebM (.webm)
- FLV (.flv)
- WMV (.wmv)
File Size Limits
Maximum file sizes vary by plan:
- Free: 10MB per file
- Pro: 100MB per file
- Enterprise: Custom limits available
Organization Structure
Understanding CoreViz's organization structure helps you plan your uploads effectively:
Organization
├── Dataset 1
│ ├── Entity A
│ │ ├── Media Item 1
│ │ ├── Media Item 2
│ │ └── ...
│ └── Entity B
│ ├── Media Item 3
│ └── ...
└── Dataset 2
└── Entity C
└── ...
Organizations
Your top-level workspace containing all datasets and configurations.
Datasets
Collections of related content, typically organized by:
- Project or campaign
- Content type or category
- Time period
- Source or department
Entities
Specific types of content within a dataset, such as:
- "Product Photos"
- "Security Footage"
- "Medical Images"
- "Marketing Assets"
Upload Methods
1. Web Interface Upload
The web interface provides the most user-friendly upload experience:
Single File Upload
- Navigate to your dataset
- Select an entity or create a new one
- Click "Upload" or drag and drop files
- Select files from your computer
- Wait for processing to complete
Bulk Upload
- Select multiple files (up to 100 at once)
- Drag and drop or use the file picker
- Monitor upload progress in the interface
- Review processing status
Folder Upload
- Use the "Upload Folder" option
- Select an entire folder from your computer
- CoreViz maintains folder structure as entities
- All files are processed automatically
2. API Upload
Coming soon.
3. CLI Upload (Coming Soon)
Coming soon.
Upload Best Practices
File Organization
Before Upload:
- Organize files into logical folders
- Use consistent naming conventions
- Remove unnecessary files
- Compress large files when possible
Naming Conventions:
product_001_red_shirt.jpg
security_cam_2024_01_15_14_30.mp4
medical_xray_patient_12345.png
Batch Processing
Large Datasets:
- Upload in batches of 100-500 files
- Monitor processing status between batches
- Use the API for automated batch uploads
- Consider upload scheduling for off-peak hours
Video Content:
- Compress videos before upload when possible
- Split very long videos into segments
- Use consistent video formats within a dataset
Metadata Preparation
Custom Metadata:
- Prepare metadata files (CSV/JSON) for bulk import
- Include relevant tags and categories
- Add descriptive information for better searchability
Example metadata file:
{
"files": [
{
"filename": "product_001.jpg",
"tags": ["clothing", "red", "shirt"],
"category": "apparel",
"description": "Red cotton t-shirt, size M"
}
]
}
Processing and Indexing
Automatic Processing
Once uploaded, CoreViz automatically:
- Validates file format and integrity
- Extracts basic metadata (size, format, creation date)
- Generates thumbnails and previews
- Analyzes content using AI models
- Indexes for search and retrieval
- Stores in optimized format
Processing Status
Monitor upload and processing status:
- Uploading: File is being transferred
- Processing: AI analysis in progress
- Indexed: Ready for search and analysis
- Error: Processing failed (check error details)
Processing Time
Typical processing times:
- Images: 2-10 seconds per image
- Videos: 1-2x real-time (e.g., 1-minute video takes 1-2 minutes)
- Large batches: Processing happens in parallel
Organization Strategies
By Project
Organization: "E-commerce Platform"
├── Dataset: "Product Catalog 2024"
│ ├── Entity: "Clothing"
│ ├── Entity: "Electronics"
│ └── Entity: "Home & Garden"
└── Dataset: "Marketing Assets"
├── Entity: "Banner Images"
└── Entity: "Product Videos"
By Content Type
Organization: "Security Company"
├── Dataset: "Surveillance Footage"
│ ├── Entity: "Entrance Cameras"
│ ├── Entity: "Parking Lot"
│ └── Entity: "Interior Cameras"
└── Dataset: "Evidence"
├── Entity: "Photos"
└── Entity: "Videos"
By Time Period
Organization: "Research Lab"
├── Dataset: "Q1 2024 Experiments"
├── Dataset: "Q2 2024 Experiments"
└── Dataset: "Q3 2024 Experiments"
Troubleshooting Upload Issues
Common Problems
Upload Failures:
- Check file format compatibility
- Verify file size limits
- Ensure stable internet connection
- Check available storage quota
Processing Errors:
- Corrupted or invalid files
- Unsupported codecs in videos
- Insufficient processing resources
- Network interruptions during upload
Slow Uploads:
- Compress large files
- Upload during off-peak hours
- Use wired internet connection
- Consider API uploads for automation
Getting Help
If you encounter issues:
- Check the FAQ for common solutions
- Review error messages in the interface
- Contact support (team@coreviz.io) with specific error details
- Check system status at status.coreviz.io
Next Steps
Now that you understand upload and organization:
- Learn Search: Master search and discovery features
- Explore Workflows: Discover AI workflows for your content
- Scale Operations: Use bulk operations for large datasets
- Integrate: Connect with integrations and APIs
Pro Tip
Start with a small test dataset to familiarize yourself with the upload process and organization structure before uploading large amounts of content.