# Uploading structured data (JSON) custom fields

{% hint style="info" %}
The bulk uploader can only be used by users who have permission to create/submit new metadata items.
{% endhint %}

[Structured data custom fields](../registry-configuration/adding-custom-fields/custom-field-structured-data-json-type) can be bulk uploaded using the JSON field from the registry's API.

### How to upload complex custom fields using JSON

1. Navigate to the 'Retrieve & Update' page of a metadata item with the custom field that you wish to upload by using the following URL format:
   * https://\[_your.registry_]/api/v5/metadata/\[_metadataitemtype_]/\[_itemUUID_]

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2Fh4pCSKD5SaZkTfWzvBUe%2Fimage.png?alt=media&#x26;token=c9b4edbc-b49a-467a-a2b5-6d24e90c4677" alt=""><figcaption></figcaption></figure>

2. Navigate to the 'customvalue\_set' section of the JSON, find the 'name' of your desired custom field, then copy its 'content' (highlighted blue below).

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FZkRJd4aZGRd5A4UlHpIT%2Fimage.png?alt=media&#x26;token=40d44fce-f0f4-43a9-b6b1-480f97aa833f" alt=""><figcaption></figcaption></figure>

3. Paste the copied content into the matching custom field's section of the [bulk upload template]().

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FeyLrgWi7zEQjX8QzqlL7%2Fimage.png?alt=media&#x26;token=2147d81a-b4a0-4961-abce-d546af6ae4f2" alt=""><figcaption></figcaption></figure>

**Notes:**

* Structured data custom fields must be uploaded using **.xlsx** format spreadsheets, not .csv
* If you wish to add new rows to the JSON text, this can be done now
  * A tool such as [this](https://jsonlint.com/) can be helpful when adding new rows to JSON text.

4. Fill in the rest of the template as normal if you have not already done so.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FTcnHlWYEuAB1p1vR7TW1%2Fimage.png?alt=media&#x26;token=e82e4056-5fab-401c-916a-2103ceeb3a5d" alt=""><figcaption></figcaption></figure>

5. Select the creation dropdown from the header, then 'See all...'

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FAfbhm7VMOn3vw9rR3f7L%2Fimage.png?alt=media&#x26;token=d80eaef4-cc54-4b8d-aac8-00405300b515" alt=""><figcaption></figcaption></figure>

6. Navigate to the 'Upload metadata' section, then select 'Upload metadata' from the 'Aristotle Bulk Creator' field.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FV8Cuw6oovHp6N8BujDln%2Fimage.png?alt=media&#x26;token=5204ec79-5b11-453a-bb80-e518027ff8da" alt=""><figcaption></figcaption></figure>

7. Select the appropriate metadata type, then upload the .xlsx template containing the structured data custom field.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FrdpH7GYbgZJWrTMy4sEW%2Fimage.png?alt=media&#x26;token=dc3bc0f8-ff27-408e-a6c4-591b00256965" alt=""><figcaption></figcaption></figure>

8. Once the template's upload completes, select 'Save metadata' to upload the items you designed.

<figure><img src="https://1464151032-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIXci0eiRxXA0UhVYnwA2%2Fuploads%2FWFU7XyfI02YmwKWNAJHk%2Fimage.png?alt=media&#x26;token=8eeea532-44c7-407f-a875-b67e5b96d27b" alt=""><figcaption></figcaption></figure>

**Note:** If the upload completes successfully, the 'Upload Metadata' field will be green (as above). If the upload does not complete successfully, the field will be red, and the failing elements of the template listed.
