> For the complete documentation index, see [llms.txt](https://docs.zephyrintel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zephyrintel.com/empire-view-assets/add-assets/bulk-import-assets-from-csv.md).

# Bulk-import assets from CSV

Create many assets at once by uploading a CSV file, instead of adding them one by one.

### Before you begin

If you do not see **Bulk Import**, your account does not have the permission to create assets. Ask your administrator.

> **Screenshot placeholder:** the Bulk Import dialog on the **Bulk Asset Upload** tab with the **Download CSV template** link, the drop zone and the Merge / Replace choice.

### Steps

1. Click **Bulk Import** in the toolbar, then choose **Bulk Asset Upload**.
2. Click **Download CSV template** for a starting file with the required columns and two example rows.
3. Fill in your rows, then drop the file onto the upload area or click it to browse.
4. Choose an import mode, then click **Next**.
5. Review the file and mode, then click **Import Assets**.

### Required columns

| Column        | Required | What to enter                                                                          |
| ------------- | -------- | -------------------------------------------------------------------------------------- |
| serialNumber  | Yes      | The asset's serial number.                                                             |
| brand         | Yes      | The asset's brand.                                                                     |
| equipmentType | Yes      | The asset's equipment type.                                                            |
| customer      | Yes      | The customer's organization ID, not its name. Also accepted as customerId or tenantId. |

The template also has optional columns for name, model, status, location and technical specifications.

{% hint style="warning" %}
The template's example rows show a customer name, such as "Acme Refining Co." Replace it with the organization ID; Signal rejects a name in the customer column. Ask your administrator if you do not know the ID.
{% endhint %}

### Import mode

* **Merge**: create assets from the uploaded rows and leave existing assets unchanged.
* **Replace**: treat the file as the latest source of truth for the assets in it.

Today, both modes create assets the same way, row by row, and neither updates or removes an existing asset.

### What you see

Signal shows a message such as "Bulk asset merge upload completed. Created 12 asset(s)," plus how many rows succeeded and how many had errors when some fail.

### Notes

* A blank name column uses the serial number as the name; a blank status column defaults to Unknown.
* Without the permission to promote assets, bulk-imported assets are saved as drafts until someone promotes them.