# Kit Items

The Kit Items Importer allows you to efficiently add or update kit items in bulk from a spreadsheet, making it ideal when you need to add many items to one or more kits at once, update quantities for existing kit items, or avoid manual, line-by-line edits in the UI. Imports are atomic, so if any row contains an error, nothing is changed.

#### Importer Behavior

* **Existing items**: If the kit already has the part (including revision), the quantity is updated. Already kitted inventory will be preserved.
* **New items**: If the kit does not already have the part, a new Kit Item is created.
* **Revisions:** If revision is not filled out, it will select the latest revision for that Part Number.
* **Duplicates in the same import**: Duplicate rows for the same Kit+Part within an import returns an error.
* **Atomicity**: Any error prevents all updates and creates. All errors collected from an import will be returned upon a failure.
* **Kit Id**: No new kits are created with this importer. kit_id is a required value, when left blank the importer will return an error.
* **ION Actions:** Actions with the `PARTKITITEM` target are triggered during the import. If the Action raises a `ValidationError` the standard error toast for Actions will be displayed and the data is not imported.

#### What You’ll See After Import

Following a successful import, a toast will be shown with the number of items imported - including updates and creates - and links to each of the kits affected by the import.

<figure><img src="/files/EDjhSLKzKVGDTn0Iiy4y" alt=""><figcaption></figcaption></figure>

When the importer encounters an error, the changes will be canceled and a table displaying the errors and the rows they occur on will be shown.

<figure><img src="/files/ETcV7ere7rwVCWUQEOCu" alt=""><figcaption></figcaption></figure>