Import images from JSON

Import images via JSON file

Uploading images via a JSON file is the recommended method when dealing with a large volume of images.

There are two ways to use this approach, depending on where your images are stored:

1. Images accessible via public URLs or internal URIs Prepare your import JSON file following the expected format and upload it through the Studio import portal. You can refer to the dedicated guide for detailed steps.

2. Images stored locally In this case, you can go with the Dataset command interface option.

Prerequisite:

Having your images accessible, we need to tell Deepomatic Studio where to find the images, as well as add any useful information associated with images. For this purpose, you need to follow the platform's expected structure in your import JSON file as explained in detail in the following.

You can also use the export features that automatically structures the JSON

Studio Import file format

Upload & Progress report

You can start the import process by dragging & dropping or browsing your well-formatted import JSON file into the image portal in your project.

As soon as the import begins, the platform launches an import job. You can track its progress directly in the import portal.

If any line in your JSON file contains an error, the platform will skip that line, continue processing the others, and log the error for review.

At the end of the import, you’ll receive a final report:

• ✅ If everything went well, you’ll be notified that the import was completed without errors.

• ⚠️ If issues are encountered, a warning will appear and a log file will be made available with detailed information about the errors.

Import completed without errors

If your import completes with errors, you’ll receive a warning notification and be given access to a downloadable log archive named result_job.zip. This archive contains three files:

• error_report.json: details all the errors that occurred during the import.

• result_report.json: provides a summary of the overall import job.

• import.json: contains a ready-to-use JSON file listing only the images that failed to import, so you can easily try again.

Warning status for imports finishing with errors

All information about your import jobs from the last 2 months is stored in the Import History, accessible via the History modal. For any imports that are completed with warnings, the associated result_job.zip log file remains available for download directly from the history.

Finding the added images

Once your images are imported, you can view them in the Explore Images tab. By default, images are grouped by import batch and sorted by upload date—which means the most recently imported images will appear on the last page.

Note that within a batch, the order of the images may differ from the order in which you dragged and dropped them.