> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neuroncx.in/llms.txt
> Use this file to discover all available pages before exploring further.

# LocationList Import (Type 10)

> Bulk-import location list records into NeuronCx from a Google Sheet using a simple Id and Value format.

## Overview

LocationList Import loads location records into NeuronCx in bulk from a Google Sheet. It's a legacy import type that uses a fixed two-column format — `Id` and `Value` — and writes directly against location records already set up for your institution.

Use this import when you need to populate or refresh location values in bulk, without touching any other entity type.

> [!NOTE]
>
> This is a legacy import type. It supports the `Id | Value` format only and does not support attribute columns. If you need to manage additional location details such as sequence numbers, addresses, or entity status, those are handled separately in the Location List edit view.

***

## Prerequisites

* Your Google Sheet must be shared with edit access so NeuronCx can read from it.
* The sheet must contain exactly two columns: `Id` and `Value`.
* The `Id` values in your sheet must match existing location records for your institution. This import does not create new location definitions — it only writes values against ones already set up.

***

## Preparing Your Sheet

Your sheet must follow this exact format. NeuronCx will reject or skip rows that don't conform.

| Column | Required | Notes |
| - | - | - |
| `Id` | ✅ Yes | Must match a valid location record ID for your institution |
| `Value` | ✅ Yes | The value to set against that location record |

![LocationList Sheet Format](https://mintlify.s3.us-west-1.amazonaws.com/neuroncx/images/locationlist_sheet_format.png)

> [!TIP]
>
> To find the correct IDs for your institution, check the location list from your institution's setup. Use only IDs that already exist — unrecognised IDs will be skipped.

***

## Running the Import

### Setting up a new import

**1. Open Imports**

Navigate to **Home > Ontology > Attribute Settings & Bulk Edit**, then click the **Imports** tab.

![Imports Tab](https://mintlify.s3.us-west-1.amazonaws.com/neuroncx/images/imports_tab.png)

**2. Click + Import**

Click the **+ Import** button in the top right to open the New Import modal.

![Import Button 6](https://mintcdn.com/neuroncx/_AQBgdbbCYYHf24I/images/import_button-6.png?fit=max\&auto=format\&n=_AQBgdbbCYYHf24I\&q=85\&s=ff35c52138377e1b641bda357f0ee10c)

**3. Give it a label**

Enter a name that describes this import — for example, "Location List Bulk Import."

![Label 5](https://mintcdn.com/neuroncx/_AQBgdbbCYYHf24I/images/label-5.png?fit=max\&auto=format\&n=_AQBgdbbCYYHf24I\&q=85\&s=c1efcdacb21e8ff469b110d810232be8)

**4. Add the Google Sheet ID**

Paste the sheet ID or the full Google Sheets URL — NeuronCx will extract the ID automatically.

![Sheet Id 1](https://mintcdn.com/neuroncx/_AQBgdbbCYYHf24I/images/sheet-id-1.png?fit=max\&auto=format\&n=_AQBgdbbCYYHf24I\&q=85\&s=b7458afedc68f6b42981f813ac7fb4b2)

**5. Verify**

Click **Verify**. NeuronCx confirms it can read the sheet and shows you the row and column count — use this to catch an empty or wrong sheet before continuing.

![Verify 7](https://mintcdn.com/neuroncx/_AQBgdbbCYYHf24I/images/verify-7.png?fit=max\&auto=format\&n=_AQBgdbbCYYHf24I\&q=85\&s=9e7490e9421d9ec3bffc92b79c81e71a)

**6. Select the import type**

In the Import type panel on the left, select **Legacy**. Then choose **LocationList** (`#10`) from the list on the right.

![Import Type](https://mintcdn.com/neuroncx/_AQBgdbbCYYHf24I/images/import_type.png?fit=max\&auto=format\&n=_AQBgdbbCYYHf24I\&q=85\&s=d41cc400040e49d217e26f8949add57a)

**7. Create the import**

Click **Create import**. The import now appears in your list under the Legacy category, ready to run.

![Create Import 6](https://mintcdn.com/neuroncx/_AQBgdbbCYYHf24I/images/create_import-6.png?fit=max\&auto=format\&n=_AQBgdbbCYYHf24I\&q=85\&s=836e3fcf545f341baeac75cf9d78cd2b)

### Running the import

**1. Find the import**

From the Data Import list, locate the import you just created. You can filter by the **Legacy** tag to narrow the list.

**2. Click Import**

Click the arrow icon on the import row to open it, then click **Import** to run it.

***

## Checking the Result

Once the run completes, the history table shows how many rows were read and how many records were updated. Click a run's **Status** to open a detailed breakdown showing which rows succeeded, failed, or were skipped.

> [!TIP]
>
> Re-running the same sheet is safe — it will re-apply values without creating duplicates.

***

## Limits to Keep in Mind

* This import supports the `Id | Value` format only. No additional columns are read or imported.
* The `Id` in each row must match an existing location record for your institution — rows with unrecognised IDs are skipped.
* This import does not create new location definitions. All IDs must be set up in the platform before running the import.
* Additional location details such as sequence numbers, addresses, and entity status are managed separately in the Location List edit view — they cannot be set through this import.
* Only one import runs at a time. If another import is already running, this one will queue and wait its turn.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.