---
title: "BulkImport"
source: /gcxone/features/bulkimport
locale: en
updated: 2026-09-29
---
## **What BulkImport Does**

BulkImport lets you onboard customers, sites, and devices at scale. Upload a filled Excel template and GCXONE creates everything automatically. No manual entry, no delays.

## **Why It Matters**

- **Onboard sites up to 5x faster** with one-click import instead of manual entry.
- **Eliminate repetitive data entry** and reduce the risk of setup errors.
- **Ensure consistent configurations** across every location from day one.
- **Stay focused on monitoring**, not manual setup.
- **Manage more without growing headcount** — one team can manage 130+ more sites per month without adding staff.

New sites go live immediately after upload. Admins stop adding entities one by one. Large deployments complete in minutes, not days.

## **How It Works**

BulkImport uses a structured Excel template. Download it, fill in the required data, and upload it back into GCXONE. The process follows three steps:

1. **Upload** \- Download the template file, fill it in, and select your Excel file (.xlsx or .xls)
2. **Preview** \- Review the data before confirming the import
3. **Complete** \- GCXONE imports the data and creates all entities instantly.

## **Key Capabilities**

BulkImport supports the following entity types:

- **Customers** — Add multiple customers at once via Configuration → Customers → Import
- **Sites** — Add multiple sites at once via Configuration → Sites → Import
- **Devices** — Add multiple devices at once via Configuration → Devices → Import

## **Use Cases**

- **Large-Scale Onboarding** — Configure hundreds of sites and devices in minutes and deploy GCXONE across multiple customers simultaneously.
- **Multi-Site Deployments** — Onboard complete customer environments, all sites and devices, in a single upload.
- **Standardized Configuration** — Prepare one Excel template and import it across all environments to help keep configurations consistent.

## **Additional Details**

### Importing Customers

1. Go to Configuration, then select Customers
2. Click Import
3. Click Download Template File
4. Fill in the required customer information in the Excel template
5. Click Browse Files and select your completed file
6. Review the preview and confirm the import

![BulkImport upload interface showing the three-step process: Upload, Preview, and Complete](/api/media/file/d13f8c7cf413bd87437f083660260dfa5c63246b-1920x1032-1.png)

*Figure 1: Customer Import*

The customer template is a single sheet named Customers with the following columns. It ships with three example rows — replace them with your own data before uploading.

| Column | Example value in the template |
| --- | --- |
| name | Customer 1 |
| email | customer1@example.com |
| description | Description for customer 1 |
| houseBuildingNumber | 877 |
| streetName | Street 1 |
| city | City 1 |
| state | State 1 |
| code | 94464 |
| country | Country |
| countryCode | CC |
| phoneNumber | +100000001 |
| externalCustomerId | ECID-1 |

### Importing Sites

1. Go to Configuration, then select Sites
2. Click Import
3. Click Download Template File
4. Fill in the required site information in the Excel template
5. Click Browse Files and select your completed file
6. Review the preview and confirm the import

![BulkImport sites import screen](/api/media/file/9ddc3df19de8ddd7e64fa6a0a8826c7fa845050e-1920x1032.png)

*Figure 2: Site Import*

### Importing Devices

1. Go to Configuration, then select Devices
2. Click Import
3. Click Download Template File
4. Fill in the required device information in the Excel template
5. Click Browse Files and select your completed file
6. Review the preview and confirm the import

If some devices fail to import — for example, with a missing associatedSiteId — BulkImport lists each failed record with its specific error, and lets you download a sheet of just the failed rows to correct and re-upload. Successfully imported devices go live immediately; only the failed rows need to be fixed and resubmitted.

![BulkImport devices import screen](/api/media/file/bd91ad9305b2db7441d7db931645e057a263af25-1920x1140.png)

*Figure 3: Device Import*

<!-- Not represented in Markdown: video. Read the page at /gcxone/features/bulkimport -->