Importing Assets
Prepare CSV or TSV asset rows in the import format, import them to create or update assets, and verify and group the results.
Import creates or updates many assets at once. You paste comma-delimited (CSV) or tab-delimited (TSV) rows into the Import Assets dialog in the Assets portal.

The Import Assets dialog, showing the row format
Preparing the Data
Each row is one asset, with its values in this order:
| Column | Required | Value |
|---|---|---|
| Product ID | Yes | The ID of the asset's copilot, or a name in the copilot's alias list. See Aliases. |
| SN | Yes | The asset's serial number. |
| Name | No | The asset's name. |
| Configuration | No | Data items from the copilot's data dictionary, as key=value pairs separated by commas, such as make=AZ Machine Works,model=AM-650. A key with a dot, such as fleet.unit, puts the value in a data object named fleet on the asset. See Asset Configuration. |
| Groups | No | The asset groups the asset belongs to, separated by commas, such as AZ Copper Works,US Customers. A group that doesn't exist yet is created. See Groups. |
Build the rows in a spreadsheet, one column per value, as in the example below. A heading row is skipped. Importing a serial number that already exists updates that asset instead of creating a new one. Copy the rows and paste them into the dialog: rows copied from a spreadsheet are tab-delimited (TSV), so the commas inside a Configuration or Groups cell stay in that cell.
CautionAn import runs in the account you are signed in to. Suppliers and customers use the same format, but a customer import, typically used to give assets their names and groups, should only be run in the customer's account.
Example
This example adds four AM-650 haul trucks to the Copilot (Truck) copilot, whose product ID is 88307. Each truck gets two data items from the copilot's data dictionary, make and model, and belongs to two asset groups: the customer group AZ Copper Works, and US Customers, a new group that the import creates.
| PRODUCT | SN | NAME | CONFIGURATION | GROUPS |
|---|---|---|---|---|
| 88307 | B45102_V12 | Haul Truck - V12 (Pit 3) | make=AZ Machine Works,model=AM-650 | AZ Copper Works,US Customers |
| 88307 | B45117_V16 | Haul Truck - V16 (Pit 3) | make=AZ Machine Works,model=AM-650 | AZ Copper Works,US Customers |
| 88307 | B45240_V12 | Haul Truck - V12 (Pit 5) | make=AZ Machine Works,model=AM-650 | AZ Copper Works,US Customers |
| 88307 | B45311_V16 | Haul Truck - V16 (Pit 5) | make=AZ Machine Works,model=AM-650 | AZ Copper Works,US Customers |
Pasted into the dialog, with the heading row:

Four haul trucks pasted into the Import Assets dialog
Import Results reports four assets created. US Customers is created with the first truck, and each truck is added to AZ Copper Works and US Customers:

Import Results: four assets and one group created
The four trucks then appear in the Assets list with both groups:

The imported trucks in the Assets list
Updating Assets
Importing the same serial numbers again updates those assets. This import adds a fleet object to each truck, with its unit number, site, and in-service date:
| PRODUCT | SN | NAME | CONFIGURATION | GROUPS |
|---|---|---|---|---|
| 88307 | B45102_V12 | Haul Truck - V12 (Pit 3) | make=AZ Machine Works,model=AM-650,fleet.unit=HT-301,fleet.site=Pit 3,fleet.in_service=2026-01-15 | AZ Copper Works,US Customers |
| 88307 | B45117_V16 | Haul Truck - V16 (Pit 3) | make=AZ Machine Works,model=AM-650,fleet.unit=HT-302,fleet.site=Pit 3,fleet.in_service=2026-02-02 | AZ Copper Works,US Customers |
| 88307 | B45240_V12 | Haul Truck - V12 (Pit 5) | make=AZ Machine Works,model=AM-650,fleet.unit=HT-501,fleet.site=Pit 5,fleet.in_service=2026-03-10 | AZ Copper Works,US Customers |
| 88307 | B45311_V16 | Haul Truck - V16 (Pit 5) | make=AZ Machine Works,model=AM-650,fleet.unit=HT-502,fleet.site=Pit 5,fleet.in_service=2026-04-21 | AZ Copper Works,US Customers |

The same trucks re-imported with fleet data
Import Results reports no assets created and four updated:

Import Results: four assets updated
On the asset's page, Configuration shows fleet as its own group, the same way it shows the values of the Component (Engine) component:

The fleet values as their own group in Configuration
Importing the Data
- Sign in to the account the assets belong to and open the Assets portal.
- Click Import in the top-right corner of the page.
- Copy the rows from your spreadsheet, CSV, or TSV file.
- Paste them into the Import Assets box.
- Click Import.
- Review Import Results: the number of assets and groups created or updated, and a row for each asset with its messages. Messages shows the rows with messages, and All shows every row. Use Download or Copy to keep the results.
- Click OK.
The assets are added to InSkill and become available in the Assets portal.
Verifying Imported Assets
After importing, verify that the assets appear correctly. The search box finds assets by name or serial number; it is a plain text search on those two fields only.
To find assets by their data values or notes, click Filters. Under Search configuration, enter a key and value, such as fleet.site and Pit 3, and click Apply. Add Item adds another key and value, and Search notes searches the assets' notes. Clear Filters removes the filters.

Filtering assets by a configuration value
Assigning Assets to Groups
NoteGroups are created and assigned automatically if they are included in the import. The steps below are for assigning them manually.
You can assign an asset to a group from either side of the relationship.
From the asset:
- In the Assets portal, open Assets.
- Select the asset you want to add to a group and click Edit.
- Under Asset Groups, search for the group.
- Select the group and click Save.
From the group:
- In the Assets portal, open Groups.
- Select the group you want to add the asset to and click Edit.
- Under Assets, search for the asset.
- Select the asset and click Save.
Assigning Asset Groups to Teams
Follow these steps to give a team member access to an asset group:
- In the Admin portal, open Team.
- Select the team member and click Edit.
- Under Asset Groups, search for the group you want to assign.
- Select the group and click Save.
Common Errors and Troubleshooting
| Error message | Cause | Solution |
|---|---|---|
| Missing required columns | A row is missing the product ID or serial number. | Make sure every row starts with the product ID and serial number. |
Updated about 6 hours ago
