# JSON Import

**JSON Import** is a feature that allows externally provided JSON-formatted data to be imported into the organization, parsed, and applied to the system. With this functionality, users can easily load previously saved list configurator settings or efficiently manage the configuration environment by adding and updating new settings.

***

### :small\_orange\_diamond: Import

Clicking the Start JSON Import button will begin the process of importing list configuration settings exported from another org.

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2Fgit-blob-c745adf7407e60ee6fe961fcf8ba440d27595370%2Flist-2.2_3-migration-import.png?alt=media" alt=""><figcaption></figcaption></figure>

***

{% stepper %}
{% step %}
**Upload JSON File**

Select and upload the JSON file that contains the list configuration settings to be imported.

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2Fgit-blob-bee7292418fbea01c54fe1db670564ad9c318c02%2Flist-2.2_3-1-migration-import-upload.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Upsert List Configuratior**

Depending on the presence of a Migration Key, a list configuration is either created as new or used to update an existing one. The Migration Key corresponds to the record ID of the imported list configuration.

{% hint style="danger" %}
If the SmallBuilder List package version differs between the source org and the current org, some objects or fields in the imported list configuration may be missing.
{% endhint %}

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2Fgit-blob-8105239fbb02ca080bd3de2a27b0f9bf81c7d502%2Flist-2.2_3-2-migration-import-upsert.png?alt=media" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="65" data-type="number">No.</th><th width="178">Area &#x26; Button</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td>Previous</td><td>You can return to the JSON file upload screen. If you selected the wrong file, click this button to go back and restart the upload process.</td></tr><tr><td>2</td><td>Imported List Configuration Information</td><td>Check the list configuration information that will be created or updated in the current org.</td></tr><tr><td>3</td><td>List Configuration Information in the Current Org</td><td><p>If a list configuration with a connected Migration Key exists in the current org, its name will be displayed automatically. If no configuration is linked, a search box will appear.</p><ul><li>You can use the search box to find list configurations that do not have a Migration Key. If you select one of the results, it will be updated. If you leave it unselected, a new list configuration will be created.</li></ul></td></tr><tr><td>4</td><td>Preview Changes</td><td>If an existing list configuration in the current org is being updated, you can review the changes that will be applied.</td></tr><tr><td>5</td><td>Create and Update Button</td><td>Starts the process of creating or updating the list configuration based on the imported settings.</td></tr></tbody></table>

**Manually Link Migration Key**

For list configurations being imported into the current org for the first time, a Migration Key is not connected. If you want to update an existing list configuration in the current org using the imported settings, you can search for and link a Migration Key.

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2Fgit-blob-f313c087b1a5863755125731a3117a74959f40bb%2Flist-2.2_3-2-migration-import-select.png?alt=media" alt=""><figcaption><p>Select List Configuration to Update</p></figcaption></figure>

{% hint style="info" %}
Only list configurations that are not linked to a Migration Key and are created from the same object will be shown.
{% endhint %}

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2Fgit-blob-8df39ad94c39a105f43251187d8fc473f3948bdc%2Flist-2.2_3-3-migration-import-update.png?alt=media" alt=""><figcaption><p>Search Existing List Configurations</p></figcaption></figure>

**Preview Changes**

If a list configuration is being updated through a connected Migration Key, you can review the changes from the existing configuration on the screen.

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2Fgit-blob-cec5c839bda4c03a9edb8e690bcedf44f5aa0097%2Flist-2.2_3-4-migration-import-diff.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**View Results**

Check the creation and update results of the imported list configuration settings.

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2Fgit-blob-eddfbbb7cb8d11199ba0b3d96ab7a88da229d11d%2Flist-2.2_3-5-migration-import-result.png?alt=media" alt=""><figcaption></figcaption></figure>

**When Objects or Fields Are Missing**

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2Fgit-blob-8ae2187d9d97628c3b019a5069d030e6711e72ca%2Flist-2.2_3-8-migration-import-missing.png?alt=media" alt=""><figcaption></figcaption></figure>

Objects and fields that were omitted are not included in successfully migrated list builders, and such missing items are displayed separately at the bottom of the result screen. Missing objects and fields may occur due to discrepancies in the SmallBuilder List package version or insufficient field-level permissions, so please check the package version and field permissions.

**When List Configurations Fail**

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2Fgit-blob-9b36e23dd0c8afa72bb8da6c7a4b90c296ad5db3%2Flist-2.2_3-6-migration-import-fail.png?alt=media" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="63" data-type="number">No.</th><th width="215">Area &#x26; Button</th><th>Description</th></tr></thead><tbody><tr><td>1</td><td>List Toggle</td><td>Open or close the list of failed list configurations.</td></tr><tr><td>2</td><td>Select List Configurator</td><td>Select one or more failed list configurations to export again as a JSON file.</td></tr><tr><td>3</td><td>Failed List Configuration Information</td><td>View details of the failed list configurator</td></tr><tr><td>4</td><td>Summary of Failure Reasons</td><td>Displays a summary of failure reasons by object within the list configuration.</td></tr><tr><td>5</td><td>Detailed Failure Reasons</td><td>View detailed failure information for each individual list configuration.</td></tr><tr><td>6</td><td>Export</td><td>Download the JSON file for the selected list configurations.</td></tr></tbody></table>

:small\_red\_triangle\_down: Detailed Failure Reasons

<figure><img src="https://3800415611-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNuSjRiJMvVhtdzNDzWBi%2Fuploads%2Fgit-blob-7fe1d9d4f9b9eb8a8db04aee26ab0ea7cc8c9be1%2Flist-2.2_3-7-migration-import-fail-detail.png?alt=media" alt=""><figcaption></figcaption></figure>

You can review the detailed reasons for migration failure, and easily identify the failed objects using the Migration Key.
{% endstep %}
{% endstepper %}