GCXONEDocumentation

BulkImport

On this page
  1. What BulkImport Does
  2. Why It Matters
  3. How It Works
  4. Key Capabilities
  5. Use Cases
  6. Additional Details

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.

BulkImport: product film.

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

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

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

Figure 3: Device Import

Was this page helpful?

Thank you — your feedback goes to the team that owns this page.

Release notes

Know when something ships

New features, fixes and integration updates for GCXONE, delivered to your inbox as they are released.

We send a confirmation link first. Every message has an unsubscribe link.