# 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.&#x20;

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://manual.firstresonance.io/features/ion-importers/kit-items.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.