Details about the device registration CSV file

Caution You may get errors if you edit your CSV text file in Excel and then try to upload it to Digi Remote Manager. Digi recommends editing the CSV text file in a different spreadsheet editor.

When registering multiple devices, the first row of the CSV file contains comma-separated column names. Subsequent rows identify individual devices by Device IDs or MAC address. When creating this CSV file, take note of these details:

  • Any blank lines, empty values, or leading and trailing white space in values and column names are ignored.

  • Values containing commas must be enclosed in double quotes.

  • If the Update existing devices setting in the is disabled, existing devices will not be updated with values from the file.

Copy 
id,install_code, mac, type, description, restricted_status, contact, location, geoposition, vendor_id, notes, tags, group, name, maintenance_mode, cellular_modem_id
XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX, 1234567890, 0A:00:00:00:00:01, ConnectPort X4, Example Description, unrestricted, Joe Schmoe, Chicago, IL. 41.881832, -87.623177, 4261412864, These are my notes, tag1, tag2, device-1, Off, 1.23412E+14

In this example:

  • The first row contains column headers.

  • Each following row contains a data record.

  • Each value in the row is separated by a comma delimiter.

Column name

Description

id

The Device ID. Either the Device ID or the MAC address is required.

install_code

The device's default password, printed on the product label sticker. Depending on the device, the default password may be required.

mac

The device's MAC address. Either the MAC address or the Device ID is required.

type

(Optional) The device model type. Depending on the device, this may be completed automatically when the device connects to Digi Remote Manager.

description

(Optional) A description of the device.

contact

The name of the contact for this device.

location

(Optional) A description of the device's location.

geoposition

(Optional) The geoposition of the device. Should be comma-separated using the format "latitude,longitude,[altitude]" for example: "44.92646,-93.39752".

vendor_id

(Optional) The system-assigned vendor ID registered for your account.

Note The vendor id can be added the first time a device is registered in Digi Remote Manager. You cannot use the CSV to change a vendor ID for a device that has already been registered to Digi Remote Manager.

notes

(Optional) Additional details about the device.

tags

(Optional) Tags to help categorize the device. Should be comma-separated, for example "tag1,tag2".

group

(Optional) The group to which the device should be added.

name

(Optional) A name of the device.

maintenance_mode

Whether the device should be in debug mode. Allowed values are On and Off.

cellular_modem_id

(Optional) The IMEI of the device's cellular modem.