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

# Trx Attribute Entity Import (Type 11)

> Create new attribute entity records in NeuronCx in bulk from a Google Sheet.

## Overview

Trx Attribute Entity Import creates new entity records in NeuronCx in bulk from a Google Sheet. For each row in your sheet, NeuronCx creates a new record, assigns it a primary ID, and writes that ID back into your sheet — so you always have a reference to exactly what was created.

You can bring in additional datastore values alongside the mandatory fields in the same run, without needing a separate import.

> [!NOTE]
>
> This import is for creating new records only (insert). If you need to update values on records that already exist, use Trx Attribute Datastore Value Update or Import (Type 8) instead.

***

## Prerequisites

* Your Google Sheet must be shared with edit access so NeuronCx can read from it and write IDs back to it.
* The attribute entity type you're importing into must already exist in NeuronCx. This import creates new entity records — but it does not create new attribute definitions.
* The sheet must include `Label` and `Description` columns — these are mandatory for every row.
* Leave the `ID` column present but empty before running the import — NeuronCx will fill it in automatically for each created record.

***

## Preparing Your Sheet

Your sheet must include the mandatory columns below. Additional datastore columns are optional — include only the ones you need.

| Column | Required | Notes |
| - | - | - |
| `ID` | ✅ Yes — leave blank | Autofilled after import with the created record's primary ID |
| `Label` | ✅ Yes | Display name for the entity record |
| `Description` | ✅ Yes | Description of the entity record |
| `Wap_InteractiveList_Title` | Optional | Title shown in WhatsApp interactive list |
| `Caption` | Optional | Caption for the entity |
| `Wap_InteractiveList_Description` | Optional | Description shown in WhatsApp interactive list |
| `Wap_InteractiveList_Caption` | Optional | Caption shown in WhatsApp interactive list |
| `WAF_ItemHiddenLabel` | Optional | Hidden label used for internal matching |

![Sheet View](https://mintcdn.com/neuroncx/_AQBgdbbCYYHf24I/images/sheet-view.png?fit=max\&auto=format\&n=_AQBgdbbCYYHf24I\&q=85\&s=262a72d79f270c50487dda3eafbeda08)

> [!TIP]
>
> Leave the `ID` column present but empty before running — NeuronCx writes the generated ID back into that column for each row after the record is created.

> [!TIP]
>
> You don't need to include every optional column. Add only the datastore columns you want to populate — columns without a header are skipped automatically.

***

## Running the Import

### Setting up a new import

**1. Open Imports**

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

**2. Click + Import**

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

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

**3. Give it a label**

Enter a name that describes this import — for example, "Doctor Categories Entity Import."

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

**4. Add the Google Sheet ID**

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

![Sheetid](https://mintcdn.com/neuroncx/_AQBgdbbCYYHf24I/images/sheetid.png?fit=max\&auto=format\&n=_AQBgdbbCYYHf24I\&q=85\&s=ab53e7d5df46fb48ea3dda3f1e75df87)

**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 8](https://mintcdn.com/neuroncx/_AQBgdbbCYYHf24I/images/verify-8.png?fit=max\&auto=format\&n=_AQBgdbbCYYHf24I\&q=85\&s=b287e570afd8966850c2d479892dfe0e)

**6. Select the import type**

In the Import type panel on the left, select **Entities & Attributes**. Then choose **Trx Attribute Entity Import** (`#11`) from the list on the right.

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

**7. Create the import**

Click **Create import**. The import now appears in your list under Entities & Attributes, ready to run.

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

### Running the import

**1. Find the import**

From the Data Import list, locate the import you just created. You can filter by **Entities & Attributes** to narrow the list.

**2. Open the import**

Click the arrow icon on the import row to open it.

![Type 11 Run Screen](https://mintlify.s3.us-west-1.amazonaws.com/neuroncx/images/type11_run_screen.png)

**3. Select the Transaction Attribute**

Choose the attribute entity you want to create records for from the **Select Transaction Attribute** dropdown. This tells NeuronCx which attribute definition to use for the new records.

**4. Click Trigger**

Click the green **Trigger** button to run the import.

***

## What Happens After the Import Runs

Once each row is processed, NeuronCx writes the generated primary ID back into the `ID` column of your sheet — matched to the row it was created from.

* Open your sheet after the import completes and confirm the `ID` column is filled in for each row.
* If a row's property type isn't configured for the selected attribute entity, that row is skipped silently — it won't appear as an error in the run log.

> [!NOTE]
>
> If some rows in your sheet still show an empty `ID` after the import, it means those rows were skipped — likely because the property type wasn't set up for the attribute entity you selected. Check with your administrator.

***

## Checking the Result

Once the run completes, the **Trigger Log** at the bottom of the screen shows each run with the workflow used, the number of rows processed, and when it ran.

| Column | What it shows |
| - | - |
| Work Flow | The workflow that processed the import |
| Rows | Number of rows processed in that run |
| Date and Time | When the trigger was fired |

![Screenshot 2026 08 29 123219](https://mintcdn.com/neuroncx/_AQBgdbbCYYHf24I/images/Screenshot-2026-08-29-123219.png?fit=max\&auto=format\&n=_AQBgdbbCYYHf24I\&q=85\&s=f595ad3f098ab760ca2ec7950936d0e2)

> [!TIP]
>
> After the import, open your Google Sheet and confirm the `ID` column is filled in for every row. Any row still showing an empty ID was skipped during the import.

## Limits to Keep in Mind

* This import creates new records only. To update existing records, use Trx Attribute Datastore Value Update or Import (Type 8) instead.
* `Label` and `Description` are mandatory — rows missing either of these will not be created.
* Leave the `ID` column blank before running — if it already contains a value, it may interfere with the write-back.
* Rows where the property type isn't configured for the selected attribute entity are skipped silently, without an error.
* Columns without a header are skipped automatically.
* 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.