> For the complete documentation index, see [llms.txt](https://docs.deepomatic.com/platform-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.deepomatic.com/platform-documentation/deepomatic-drive/adding-and-managing-data/adding-images/upload-images-text-file/import-images-from-json.md).

# Import images from JSON

## Import images via JSON file 

{% hint style="info" %}
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](broken://pages/myDwMRAiZA8z9AT8WP95)[ command interface](broken://pages/myDwMRAiZA8z9AT8WP95) option.
   {% endhint %}

## 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.

{% hint style="info" %}
You can also use the export features that automatically structures the JSON 
{% endhint %}

{% content-ref url="/pages/sSioKqr6anFTOJIOSfqV" %}
[Studio Import file format](/platform-documentation/deepomatic-drive/adding-and-managing-data/adding-images/upload-images-text-file/import-images-from-json/studio-import-file-format.md)
{% endcontent-ref %}

## 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.

<figure><img src="https://2627694381-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmfYsBwyGGbiAMWJv9xC%2Fuploads%2FJPZCJJoWM9EqtiMkjH0p%2FCapture%20d%E2%80%99e%CC%81cran%202025-04-15%20a%CC%80%2011.25.11.png?alt=media&amp;token=9ba65dab-bb02-457a-84d4-4db5542d8ebf" alt=""><figcaption></figcaption></figure>

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.

<figure><img src="https://2627694381-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmfYsBwyGGbiAMWJv9xC%2Fuploads%2FAl5KkJl2HQtF6TKC15p0%2FScreenshot%202024-03-21%20at%2018.52.13.png?alt=media&amp;token=e966efe2-2dde-416a-8766-d7a588cb9250" alt="" width="563"><figcaption><p>Import completed without errors</p></figcaption></figure>

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.

<figure><img src="https://2627694381-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmfYsBwyGGbiAMWJv9xC%2Fuploads%2FnjSXau7ttOxHm6iHX0Ag%2FScreenshot%202024-03-21%20at%2018.44.57.png?alt=media&amp;token=d562573a-550c-4434-b2b4-35dd67f7042e" alt="" width="563"><figcaption><p>Warning status for imports finishing with errors</p></figcaption></figure>

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.

<figure><img src="https://2627694381-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgmfYsBwyGGbiAMWJv9xC%2Fuploads%2F0ZEdFKugRPxQHjXSDyh7%2FScreenshot%202024-03-21%20at%2019.09.32.png?alt=media&amp;token=f2474e8b-e208-4513-99c8-0652f649b72d" alt="" width="563"><figcaption></figcaption></figure>

## 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.