# The manual for the New ION Experience has been released.

Check it out! [Documentation Index](https://docs.firstresonance.io/)

For the complete documentation index, see [llms.txt](https://manual.firstresonance.io/llms.txt). This page is also available as [Markdown](https://manual.firstresonance.io/features/ion-importers/kit-items.md).

## The Kit Items Importer

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.

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.