Roboflow Docs
DashboardResourcesProducts
  • Product Documentation
  • Developer Reference
  • Changelog
  • Roboflow Documentation
  • Quickstart
  • Workspaces
    • Workspaces, Projects, and Models
    • Create a Workspace
    • Rename a Workspace
    • Delete a Workspace
  • Team Members
    • Invite a Team Member
    • Role-Based Access Control (RBAC)
    • Change a Team Member Role
    • Remove a Team Member
  • Single Sign On (SSO)
  • Workflows
    • What is Workflows?
    • Create a Workflow
    • Build a Workflow
    • Test a Workflow
    • Deploy a Workflow
    • Workflow Examples
      • Multimodal Model Workflow
    • Share a Workflow
    • Workflows AI Assistant
  • Enterprise Integrations
  • Workflow Blocks
    • Run a Model
      • Object Detection Model
      • Single-Label Classification Model
    • Visualize Predictions
      • Bounding Box Visualization
      • Label Visualization
      • Circle Visualization
      • Background Color Visualization
      • Classification Label Visualization
      • Crop Visualization
  • Dataset Management
    • Create a Project
    • Upload Images, Videos, and Annotations
      • Import Data from Cloud Providers
        • AWS S3 Bucket
        • Azure Blob Storage
        • Google Cloud Storage
      • Import from Roboflow Universe
    • Manage Datasets
      • Dataset Batches
      • Search a Dataset
      • Set Dataset Classes
      • Add Tags to Images
      • Create an Annotation Attribute
      • Download an Image
      • Delete an Image
    • Dataset Versions
      • Create a Dataset Version
      • Preprocess Images
      • Image Augmentation
        • Add Augmentations to Images
      • Delete a Version
    • Dataset Analytics
    • Merge Projects
    • Rename a Project
    • Delete a Project
    • Project Folders
    • Make a Project Public
    • Download a Dataset
  • Annotate
    • Introduction to Roboflow Annotate
    • Annotate an Image
      • Keyboard Shortcuts
      • Comment on an Image
      • Annotation History
      • Similarity Search
    • AI Labeling
      • Label Assist
      • Enhanced Smart Polygon with SAM
        • Smart Polygon (Legacy)
      • Box Prompting
      • Auto Label
    • Set Keypoint Skeletons
    • Annotate Keypoints
    • Annotate Multimodal Data
    • Collaborate on Labeling
    • Annotation Insights
  • Roboflow Labeling Services
  • Train
    • Train a Model
      • Train from a Universe Checkpoint
      • Train from Azure Vision
      • Train from Google Cloud
    • Roboflow Instant
    • Cancel a Training Job
    • Stop Training Early
    • View Training Results
    • View Trained Models
    • Evaluate Trained Models
  • Deploy
    • Deploy a Model or Workflow
    • Supported Models
    • Managed Deployments
    • Serverless Hosted API V2
      • Use in a Workflow
      • Use with the REST API
      • Run an Instant Model
    • Serverless Hosted API
      • Object Detection
      • Classification
      • Instance Segmentation
        • Semantic Segmentation
      • Keypoint Detection
      • Foundation Models
        • CLIP
        • OCR
        • YOLO-World
      • Video Inference
        • Use a Fine-Tuned Model
        • Use CLIP
        • Use Gaze Detection
        • API Reference
        • Video Inference JSON Output Format
      • Pre-Trained Model APIs
        • Blur People API
        • OCR API
        • Logistics API
        • Image Tagging API
        • People Detection API
        • Fish Detection API
        • Bird Detection API
        • PPE Detection API
        • Barcode Detection API
        • License Plate Detection API
        • Ceramic Defect Detection API
        • Metal Defect Detection API
    • Dedicated Deployments
      • Create a Dedicated Deployment
      • Make Requests to a Dedicated Deployment
      • Manage Dedicated Deployments with an API
    • Batch Processing
    • SDKs
      • Python inference-sdk
      • Web Browser
        • inferencejs Reference
        • inferencejs Requirements
      • Lens Studio
        • Changelog - Lens Studio
      • Luxonis OAK
    • Upload Custom Model Weights
    • Download Model Weights
    • Enterprise Deployment
      • License Server
      • Offline Mode
      • Kubernetes
      • Docker Compose
    • Model Monitoring
      • Alerting
  • Universe
    • What is Roboflow Universe?
    • Find a Dataset on Universe
    • Explore Images in a Universe Dataset
    • Fork a Universe Dataset
    • Find a Model on Universe
    • Download a Universe Dataset
  • Set a Project Description
  • View Project Analytics
  • Support
    • Share a Workspace with Support
    • Delete Your Roboflow Account
    • Apply for Academic Credits
  • Billing
    • Premium Trial
    • Credits
      • View Credit Usage
      • Enable or Disable Flex Billing
      • Purchase Prepaid Credits
    • Plans
      • Purchase a Plan
      • Cancel a Plan
      • Update Billing Details
      • Update Payment Method
      • View Invoices
Powered by GitBook
On this page
  • How to Add Data
  • Upload Data with the Web Application
  • Upload Video
  • Upload Datasets with the Command Line
  • View Your Uploaded Data
  • Image Size limits
  • Duplicate Images
  • Data Ownership
  • Data Privacy

Was this helpful?

  1. Dataset Management

Upload Images, Videos, and Annotations

Upload images, videos, and annotations to Roboflow.

PreviousCreate a ProjectNextImport Data from Cloud Providers

Last updated 10 days ago

Was this helpful?

The first step to training and deploying a model with Roboflow is to upload data to a Project.

First, you will need to .

Then, you will be taken to a web page from which you can upload data. You can also access this page from the "Upload Data" button available in your project sidebar.

How to Add Data

You can add data to your Roboflow account by:

  • Using the web application: Recommended for datasets with fewer than 1,000 images.

  • Using the command line: Recommended for datasets with greater than 1,000 images.

  • Using the Dataset Upload Workflow Block: Recommended for collecting data from Workflows with a model already in production.

From the web application and command line, you can upload:

  • JPG, PNG, WEBP, and BMP images .

  • MOV and .mp4 videos.

You can only upload annotations with images. You cannot upload annotations for images that have already been imported into your dataset.

Upload Data with the Web Application

When you create a project, or on the Upload Data page, you will see a box into which you can drag and drop images, videos, and annotations:

How file names are processed

We sanitize class names both at upload/import and export so image file names can be standardized. At upload and dataset export, we perform the following:

  • Trimming leading/trailing whitespace

  • All whitespace (including newlines & tabs) are converted to a space

  • Double spaces are removed

  • /.[]#~* characters are replaced with a dash (-)

  • |'" characters are removed

Upload Video

Uploaded videos are broken up into individual frames you can annotate. If you upload a video, a window will open from which you can choose how often frames are sampled for use in your dataset:

Once you click "Choose Frame Rate", your video will be split up into frames. These frames will then be uploaded to your dataset.

Once you have uploaded your dataset, you will be able to assign the data for labeling.

Once you drop them into the Web UI, a dialog box will ask you to choose the frame rate. This will tell us how many images we should sample from your video per second.

  • The highest frame rate you can select is 60 frames per second, which will generate 60 images for each second of video you upload.

  • The lowest frame rate you can select is 1 frame per 60 seconds.

After sampling from your video, the images will appear as if you had originally uploaded images to Roboflow.

Upload a YouTube Video

You can also import a YouTube video directly using a similar process as shown above by pasting a YouTube link on the Upload page.

Supported video file formats

Roboflow uses your browser's built in support for video files to parse videos into frame images that you can use to train your models. That means you can use many different video formats, including MOV and MP4 files, depending on what browser you are using.

Note that e.g. HEVC/H.265 encoded MP4 files are only supported by the Safari browser. If you are importing from a GoPro or iPhone that shoots in H.265 you may want to change the settings to H.264 which is more widely supported.

Upload Datasets with the Command Line

You can upload larger datasets using the Roboflow Python command line interface.

To get started, first install roboflow-python:

pip install roboflow-python

Finally, prepare a command in the following format:

roboflow import -w testupload -p project-1-8zgld /path/to/dataset/folder

Here are the arguments you need to specify:

  • -w testupload: This is the name of the batch that will be created.

  • -p <project-id>: This is your project ID.

When you run the command, you will see a message that indicates the upload process has started. You will then see logs as images upload:

We have a video walkthrough that shows how to upload data from the command line:

View Your Uploaded Data

All data uploaded to Roboflow is uploaded in a "batch". These batches can be viewed on your Project Annotate page:

Image Size limits

The maximum size for an image is 20 MB

The maximum pixel dimensions are 16,400 × 10,900 pixels.

Duplicate Images

If you try to upload an image that is already in a Project, upload for that image will be skipped.

Data Ownership

You retain all ownership rights in any content, information, or materials You post, submit, publish, display, or transmit

Data Privacy

Public Plan: If you are on the Public plan unless explicitly specified and arranged by Roboflow, your datasets will be public on Roboflow Universe.

Paid Plans (including Enterprise): Unless otherwise specified, your data is private to your account.

The formats supported vary depending on your project type.

You can .

If you are having trouble getting your video file loaded into Roboflow, you can post on our or contact your account representative.

You can only upload images with the command line interface. If you have videos, you will need to . These files can then be uploaded to Roboflow.

Next, .

If you , the merged dataset and the two original datasets exist in your account. Therefore, there is no charge for the merge, because the images are duplicates.

You retain ownership over all images and videos you upload to Roboflow. This is defined in :

create a Project
Annotations in any supported format.
Over 40+ formats are supported.
check which video formats are supported by your browser
forum
split them into frames saved as files
retrieve your Workspace ID
merge two datasets
our Section 23B of our Terms of Service
Uploading a dataset using the command-line