Guides
Start typing to search…
  1. Datasets
  2. Upload Data

Upload Assets

Learn how to upload images to your datasets, manage uploads, and troubleshoot common issues.

Assets are the images or videos you add to datasets for annotation and training. Datature Vi supports both image and video uploads, providing flexible upload options to accommodate different workflows and dataset sizes.

This document explains how to upload assets to your datasets, monitor upload progress, and handle common upload scenarios.

📷

Asset types

Datature Vi supports two types of assets:

  • Images — JPEG, PNG, TIFF, and other image formats
  • Videos — MP4, MOV, WebM, and other video formats

See the respective pages for format-specific details, limitations, and best practices.

💡

Quick workflow

Create dataset → Upload images (you are here) → Add annotations → Train a model

📋

Prerequisites

Before uploading assets, ensure you have:

Upload via web interface

The web interface provides an intuitive drag-and-drop experience for uploading images and videos directly from your browser.

Best for: Quick uploads, small to medium datasets, visual workflows

Steps to upload

  1. Navigate to your dataset and click the Explorer tab
Dataset Explorer page
  1. Click Upload or drag images or videos directly onto the upload area
Upload dialog
  1. Select your images or videos and click Upload Files
File preparation screen

Your upload will process in the background. You can continue working while it completes.

Upload options

Single or multiple files: Click the upload button to select individual files from your file browser

Folder drag-and-drop: Drag an entire folder from your file explorer directly into the upload area to upload all assets at once

Batch uploads: For best performance, upload in batches of 10-50 files at a time for large datasets

Benefits

  • No coding or technical setup required
  • Visual file selection and preview
  • Immediate feedback on upload status
  • Real-time progress tracking
  • Drag-and-drop support for easy uploads
  • Background processing allows you to continue working

Limitations

  • Best suited for datasets under 1,000 assets
  • Requires browser session to remain open during active upload
  • Limited automation options for repeated uploads
💡

For large datasets or automation

If you need to upload thousands of assets, automate uploads, or integrate with CI/CD pipelines, use the Vi SDK for programmatic uploads.

Track upload progress

Monitor your upload status in the progress indicator at the bottom of the screen:

Upload progress indicator

The progress indicator shows:

  • Number of files uploaded — Current count of successfully processed files
  • Total files — Total number of files in the upload batch
  • Upload status — Real-time status of the upload operation
  • Errors or warnings — Any issues encountered during upload

Background processing

Uploads continue in the background even if you navigate away from the page. You can:

  • Continue working in other parts of Datature Vi
  • Close the upload dialog while processing continues
  • Check the notification icon for updates when uploads complete
  • Return to the Explorer tab to see newly uploaded assets

Supported file formats

Datature Vi supports a wide range of file formats for both images and videos.

Image formats

For detailed information about supported image formats, file specifications, and best practices, see Uploading Images.

Supported formats include: JPEG, PNG, TIFF, BMP, WebP, HEIF, AVIF, JPEG 2000, and GIF.

Video formats

For detailed information about supported video formats, file specifications, and video-specific considerations, see Uploading Videos.

Supported formats include: MP4, MOV, AVI, WebM, MKV, and more.

Upload limits and best practices

File size limits

  • Maximum file size: 256 MB per image, 512 GB per video
  • Recommended size for images: Under 10 MB for optimal performance
  • Recommended size for videos: Under 100 MB for optimal performance

For format-specific details and considerations:

Best practices for web uploads

Upload strategy:

  • Upload in batches of 10-50 files at a time for better reliability
  • For large datasets (1,000+ assets), consider using the Vi SDK
  • Ensure stable internet connection before starting large uploads
  • Keep browser tab open during active upload
  • After upload, add annotations to prepare for training

Browser recommendations:

  • Use modern browsers: Chrome, Firefox, Safari, or Edge
  • Close unnecessary tabs to free up browser memory
  • Disable browser extensions that might interfere with uploads

Asset preparation:

  • Optimize assets before upload if possible to reduce file size
  • Use consistent file formats within a dataset
  • Remove corrupt or invalid files before uploading
  • Use unique filenames to avoid accidentally overwriting existing assets
  • Organize files in folders by category for easier batch uploads

For more detailed best practices:

Troubleshooting

Upload is slow or failing

Possible causes:

  • Slow or unstable internet connection
  • Files exceeding size limits
  • Too many files in a single batch
  • Browser memory limitations

Solutions:

  • Check your internet connection speed and stability
  • Upload in smaller batches (10-20 images at a time)
  • Verify all images are under 256 MB (10 MB recommended)
  • Close unnecessary browser tabs to free memory
  • Try using the Vi SDK for large uploads
  • Refresh the page if uploads appear stuck
Files not appearing after upload

Possible causes:

  • Upload still processing in background
  • Browser cache issues
  • Network interruption during upload

Solutions:

  • Wait a few minutes for processing to complete
  • Refresh the dataset explorer page
  • Check the notification icon for upload status
  • Verify the upload completed successfully
  • Re-upload if files are missing
Unsupported file format error

Possible causes:

  • File extension not in supported list
  • Corrupt or invalid image file
  • File renamed with incorrect extension

Solutions:

  • Verify file is in a supported format
  • Open the image in an image editor to confirm validity
  • Convert unsupported formats using image conversion tools
  • Re-export images from their source application
File too large error

Possible causes:

  • Image exceeds 256 MB limit
  • High-resolution uncompressed images
  • Upload may be slow for files over 10 MB

Solutions:

  • Compress images using image optimization tools
  • Reduce image dimensions if appropriate for your use case
  • Convert to a more efficient format (e.g., JPEG with moderate compression)
  • Keep images under 10 MB for optimal performance

Handling duplicate files

When you upload a file with the same filename as an existing asset in your dataset:

Default behavior: The new file replaces the existing asset, and any linked annotations are removed.

⚠️

Important

Replacing assets will delete any annotations associated with the original file. Make sure you want to replace the asset before uploading.

Best practice: Use unique filenames for different images to avoid accidentally overwriting existing assets and losing annotation work.

💡

Advanced control with SDK

If you need programmatic control over duplicate file handling (such as keeping existing annotations), use the Vi SDK's upload options.

Programmatic uploads with the Vi SDK

For large-scale uploads, automation, or integration with existing workflows, use the Vi SDK to upload assets programmatically.

Use the SDK when you need to:

  • Upload thousands of images efficiently
  • Automate uploads as part of CI/CD pipelines
  • Control duplicate file handling behavior
  • Implement advanced error handling
  • Integrate with existing data processing workflows

SDK Resources:

Common questions

Can I upload additional assets after creating a dataset?

Yes, you can upload additional images or videos to a dataset at any time. Simply navigate to the dataset's Explorer tab and upload more assets as needed.

What happens when I upload files with duplicate names?

When you upload a file with the same name as an existing asset, the new file will replace the old one and any annotations linked to the old asset will be removed. To control this behavior programmatically, use the Vi SDK's upload options.

Why are my assets not uploading?

Common reasons include:

  • Insufficient quota — Your account may have reached its monthly upload limit
  • File size too large — Ensure files are under 256 MB
  • Unsupported format — Verify your files are in a supported format
  • Network issues — Check your internet connection

Check your usage quota in your organization settings to monitor your monthly limits.

Can I delete assets after uploading?

Yes, you can delete assets from the Explorer tab or using the SDK. Note that deleting assets will also remove any associated annotations.

Do uploaded assets get modified or compressed?

Images: Images uploaded through the web interface or SDK are stored in their original format and quality. No compression or resizing is applied.

Videos: Videos may be resized and compressed for optimal playback in the annotator. See Video processing for details.

Can collaborators upload assets to shared datasets?

Yes, team members with appropriate permissions can upload assets to datasets within the organization. Manage team permissions in your organization settings.

Should I use the web interface or the SDK?

Use the web interface when:

  • Uploading small to medium datasets (under 1,000 assets)
  • You want a visual, drag-and-drop experience
  • You're doing one-time or occasional uploads
  • You don't need automation

Use the SDK when:

  • Uploading large datasets (1,000+ assets)
  • You need to automate uploads
  • You're integrating uploads into existing workflows

Learn more about SDK uploads

Next steps

After uploading assets, you can:

Related resources

Need help?

We're here to support your VLMOps journey. Reach out through any of these channels:

Contact Support

Get help from our team via our website or email us at [email protected]

Join Our Community

Connect with other Datature users, share ideas, and get community support on Slack

Explore Resources
Schedule a Demo

Book a personalized demo to see how Datature Vi can accelerate your vision AI projects

Updated about 1 month ago