Labelbox documentation

Customer-secured URLs

To import URLs to your cloud-hosted files, you will need to create a JSON or CSV file containing the URLs and optional external IDs.Create JSON file

If you would rather upload private URLs to Labelbox, you can follow the recommendations in this section for protecting your URLs.

You can also include Attachments (contextual information for labelers) in your import file.

To import your JSON or CSV file via the Labelbox UI, follow these steps:

  1. Create your import file.

  2. Go to

  3. Click Choose files to upload or drag and drop your import file.

  4. To rename your dataset, you can select it from the Datasets tab and directly edit its name at the top.

To import your JSON file via the GraphQL API, see our Bulk import section in the GraphQL docs.


To import a JSON file via the Python SDK, the JSON file must be formatted differently. See our Python docs to learn more.