Import and update assets using excel
Overview: importing assets from Excel
The Excel asset import in the Asset module lets you create many assets at once by uploading a spreadsheet and mapping its columns to CxPlanner asset fields, which is used when populating a new asset-based project or loading an equipment list handed over by a contractor.
To update assets that already exist, or to import from CSV, see Import and update assets from CSV and Import and update assets with Excel (advanced). For the full list of fields you can map to, see Asset fields reference - standard attributes in the Asset module.
- Your role must be Manager or higher.
- You can find the menu at Asset module - Asset Overview - Options - Import Assets.
- This changes assets in the project, asset types available to the project, and any fields you map during import.
This is also the method to use for a bulk import, a mass upload of equipment, or loading an existing asset list or equipment schedule from a spreadsheet (.xlsx) into CxPlanner.
What CxPlanner does during an Excel asset import
- Reads the first row of your file as column headers
- Attempts to map each column automatically to a matching CxPlanner asset field
- Shows a quality control preview so you can check values before anything is written
- Detects asset types in your file that do not yet exist in the project and offers to create them
- Writes all mapped fields onto the new assets in a single operation
Requirements for the Excel import file
Requirement | Description |
|---|---|
File type | Excel (.xlsx) or CSV |
First row | Must contain column headers |
Structure | Must match, or be mappable to, CxPlanner asset fields |
Project role | Manager or higher |
Columns whose names match a CxPlanner asset field are mapped automatically. Columns whose names differ can be mapped by hand during the import. A column left unmapped is not imported, and a missing mapping on a required field can cause the import to fail or complete with gaps.
How to import assets from Excel
Start the import
- Go to Project Dashboard.
- Navigate to Asset Overview.
- Click Options.
- Select Import Assets.
Upload your file
- Click Choose File.
- Upload your Excel (.xlsx) or CSV file.
Map columns to CxPlanner asset fields
- Review the automatic mapping.
- Check that every column you need is matched to the correct field.
- Adjust any mapping by hand where the names differ. For example, a column called
ModelTypemaps to the Model field, and a column calledMyNamemaps to the Name field. - Click OK when the mapping is complete.
Review the data before importing
- Review the quality control overview.
- Check the values and the column accuracy.
- Make any adjustments needed.
- Click Add All to proceed.
Confirm any new asset types
- If CxPlanner detects asset types that do not exist yet, for example Generator or CRAC, it will prompt you.
- Click Yes to confirm creation.
- Optionally add further details to the new types.
- Continue the import.
Video guide: importing assets from Excel
Results: importing assets from Excel
- Assets appear in Asset Overview
- All mapped fields are populated automatically
- Newly created asset types become available for the rest of the project
- Unmapped columns are ignored and their data is not stored
Situation | Result |
|---|---|
Column names match a CxPlanner field | Mapped automatically |
Column names differ | Manual mapping required |
Column left unmapped | Data in that column is not imported |
Asset type not yet in the project | You are prompted to create it |
Troubleshooting: importing assets from Excel
Problem | Cause | Solution |
|---|---|---|
Columns not mapping correctly | Column names do not match CxPlanner field names | Map the fields manually in the mapping step |
Import fails immediately | Missing or incorrect header row | Make sure the first row of the spreadsheet contains column headers |
Data appears incorrect after import | Invalid or inconsistent values in the file | Review the data in the quality control preview before clicking Add All |
Some assets missing an asset type | New types were not approved during import | Re-run the import and click Yes when prompted to create the new types |
A column of data did not import | The column was left unmapped | Re-run the import and map that column, or add the values with a bulk update |
Cannot see the Import Assets option | Project role is below Manager | Ask a project Admin to raise your role |
Updated on: 07/31/2026
Thank you!