Skip to content

Tools / CSV Error Translator

Multiple selections are split, repeated, or missing ​

Check the separator and the complete intended set. Routing locations have their own whitespace requirements.

A selection is repeated ​

Message looks like

  • There is already an item with that name or name/parent combination

What it means

A multi-select column repeats the same value inside one cell, and NetSuite refuses the duplicate selection.

Import context: General imports.

Check this first

Find the multi-select column and remove any value or internal ID that appears twice in the same cell.

Show the steps

Steps for this error

  1. Find the multi-select field column in the file.
  2. Remove values that appear twice in the same cell, including repeated internal IDs.
  3. Retry one row.

Documentation checked September 16, 2026.

A separator splits an identifier ​

Message looks like

  • Multiple values found for a dropdown field that can only take one

What it means

The multi-select delimiter also appears inside a value, often an external ID with special characters, so one value reads as several.

Import context: Inventory items.

Check this first

Set the Custom Multi-Select Value Delimiter in Advanced Options to a character your data never contains.

Show the steps

Steps for this error

  1. On the import’s Advanced Options, set the Custom Multi-Select Value Delimiter to a character that does not occur inside your values, especially external IDs with special characters.
  2. Do not use a space or a character your data contains, such as a pipe or slash. A NULL setting behaves like a space.
  3. Retry one row.

Documentation checked September 16, 2026.

An item update would remove a subsidiary already in use ​

Message looks like

  • used on a transaction

What it means

The imported subsidiary list may replace the existing selections and leave out a subsidiary needed by earlier transactions.

Import context: Item records.

Check this first

Prepare the complete intended set in one multi-select cell, including subsidiaries that must remain. Check the separator and mapping. Do not solve this by changing the historical transactions.

Show the steps

Steps for this error

  1. Subsidiary is a multi-select field: list every subsidiary the item should keep in one cell, separated by the configured delimiter, rather than only the one being added.
  2. Map the item name to Item Name/Number and the combined value to Subsidiary.
  3. Retry one item and confirm no existing subsidiary was dropped.

Documentation checked September 16, 2026.

Routing locations need a separator or subsidiary check ​

Message looks like

  • Invalid location reference key

What it means

A routing location cannot be matched: a typo, a location outside the routing's subsidiary, or spaces around the multi-select delimiter.

Import context: Manufacturing routings.

Check this first

Check the location spelling and subsidiary, and remove spaces around the delimiter for multiple locations.

Show the steps

Steps for this error

  1. Check the location value for a typo.
  2. Confirm the location is valid for the routing’s subsidiary.
  3. For several locations, check the multi-select formatting: spaces around the delimiter cause this error.
  4. Retry one routing.

If that looks right ​

The routing-specific documentation warns about spaces around the multi-select separator. Check the accepted format for this routing import. Keep actual identifiers intact.

Documentation checked September 16, 2026.

Browse all errors

Book a free 30-minute look at your import error

Bring the error and your file to a screen share and I will dig into it live. Thirty minutes is usually enough to find what is wrong and tell you what fixing it takes. Sometimes that settles it on the call; when it does not, you leave with a straight answer instead of a mystery. No cost and no obligation.

An import that keeps failing is often the first visible sign of a larger setup problem. Most of my client work starts exactly here: somebody mid-import, a file that will not load, and nobody on their side to email. If a migration or implementation sits behind this error, that is the work I do every week.

NetSuite Implementation Advisory & Administration