---
title: Device Bulk Import
slug: singleconnect-reference-guide-3-1-0/device-bulk-import
description: Learn how to efficiently add devices in bulk to Single Connect with step-by-step instructions and a convenient template file. This document covers the bulk import option for adding new devices to the inventory. Discover the rules and descriptions for each
docTags: 
createdAt: 2022-07-26T14:10:33.000Z
---

You can add devices in bulk to Single Connect.

:::hint{type="info"}
Device Bulk Import can only be used to add new devices for the first time. Bulk Import does not work for updating existing device information and assigning current devices to other device groups. If a device is already in the inventory, you cannot edit the device or add it to another device group with the bulk import option.
:::

To add devices in bulk:

1. Navigate to **Administration** > **Device Bulk Import**. **Device Bulk Import&#x20;**&#x73;creen opens.
2. Click **Download Template.** An Excel file named deviceBulkImportTemplate is downloaded.

![](https://api.archbee.com/api/optimize/g9cApVza9NIhSh0pjZYtA/nWNQiVLTcDTyEzwOXeBjS_image.png "Download Bulk Import File")

- Open the template file and enter device’s information as described in the column descriptions.
- Save the template file on your computer.
- On the **Device Bulk Import** screen, click **Browse** and select the template file you saved.
- Click **Upload File** to add the device list to the **Parse Results&#x20;**&#x73;ection on the **Device Bulk Import** screen.
- Click **Import Devices.**

You added the devices to their specified device groups in the Device Inventory.

### Device Bulk Import Rules and Template Column Descriptions

To add devices in bulk successfully to Single Connect, read the descriptions below and add
device information accordingly.

![](https://api.archbee.com/api/optimize/g9cApVza9NIhSh0pjZYtA/OF1v47-8KGUuMFAv5C-c3_image.png "Rules to fill Bulk Import File")

| **Column**      | **Required/Optional** | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| --------------- | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| No              | Required              | No refers to the row number.<br />Enter each device in a separate row.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| IP Address      | Required              | Enter the device’s IP address.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Hostname        | Required              | Enter the device’s hostname.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Access Protocol | Required              | Select the device’s access protocol.&#xD;<br />&#xD;**Examples**: &#xD;<br />SSH2 for Linux devices &#xD;<br />RDP for Windows devices&#xD;                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Port            | Optional              | Enter the device’s port number. If you leave this<br />field blank, the default port number for the access control (e.g., 22 for SSHv2, 3389 for RDP, etc.) is used.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Element Type ID | Required              | Select the device’s element type ID.<br />Examples:<br />Windows, Centos, Cisco XR, Linux                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Device Group(s) | Optional              | Enter device group name(s). Separate multiple group names with a semicolon. (Ex: DG1; DG2; DG3)<br />**Adding Devices to Parent or Child Groups**<br />Separate parent device groups from the child device groups with a forward slash (/). Forward slash (/) at the start of a device group path indicates that the first group is the parent device group. Ex: /ParentDG/ChildDG1/ChildDG2<br />A device group cannot have both the device group and the device. Only the sub-group at the bottom of the device group tree can have devices.<br />When adding a device to **ChildDeviceGroup2**, you can enter the group name in the following ways:<br />* /ParentDeviceGroup/ChildDeviceGroup1/ChildDeviceGroup2
* ParentDeviceGroup/ChildDeviceGroup1/ChildDeviceGroup2 
* ChildDeviceGroup1/ChildDeviceGroup2
* ChildDeviceGroup2<br />::Image[]{src="https://api.archbee.com/api/optimize/g9cApVza9NIhSh0pjZYtA/MqyJiDI5_Ix502w9iYzYr_image.png" size="60" width="301" height="165" position="center" showCaption="false"}<br />A device group path can contain up to 10 device groups with parent and child relationships.<br />**Entering new groups**<br />If the group name you enter does not exist, the application creates a new group with the given name.<br />Device group names must be unique and cannot contain a forward slash (/). |
| Region          | Required              | Select the device’s region or select the **No Region** option from the<br />dropdown.<br />This column appears if the region (aioc.region.field.visibility)<br />parameter is enabled in the system.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
