Edit devices in bulk

You can edit your devices in bulk to quickly update information for multiple devices. To do this, you must first export a list of your devices in Fleet, edit the information in the exported list, and then upload the edited list to Fleet. When you export your device list, you have the option to either export all devices associated with your account or export a custom CSV that has your relevant fields and devices.

Complete the following procedures to edit your devices in bulk:

1. Export and edit device list
   • All devices
   • Custom list of devices
2. Upload device list

To export and edit all devices in bulk

1. Log in to Fleet at fleet.cortexpowered.com.
2. Click Devices, then Bulk Edit in the side navigation bar. The Bulk Edit Devices view appears.
3. Click Export Current Devices Config as .csv to download the existing data for all devices associated with your account. The CSV file downloads to your computer.
4. Open the template and edit the following fields to update the device information:
   • device_id—This ID is automatically generated to uniquely identify each device.
   • device_name—This name of the device.
   • is_agent—This is for devices running the agent. For the agent to run with full functionality, this is a required field and must be set to true.
   • (Optional) lat_long—The location of the device.
   • network_name—The network in which the device should be included. The network name needs to be a network that already exists in Fleet.
   • (Optional) operating_hours:{day}—The operating hours for the corresponding day in 24 hour format. The hours appear from 0 (12:00AM) to 24 (11:59PM) for each day (mon, tues, wed, thurs, fri, sat, sun). At this time, only hours (not minutes) are supported.
     • To edit existing device-level operating hours, the export only includes the  columns for existing device-level operating hours. Edit the hours in the corresponding column day from 0 (12:00AM) to 24 (11:59PM). For example, if you want your operating hours for a device to be from 5AM to 3PM on Tuesday, update the operating_hours:tues column to 5-15 in the row of the device.
     • To add new device-level operating hours, add a new column with the operating hours parameter. For example, if you want your operating hours for a device to be from 7AM to 11PM on Monday, add a new operating_hours:mon column and add 7-24 in the row of the device.
     • If you have multiple operating hours in a single day, use a semicolon (;) to add multiple hours. For example, if you want your operating hours for a device to be from 7AM to 11AM and 5PM to 9PM on Wednesday, add 7-11;17-21 to the operating_hours:wed column.
   • override_network_operate_hours—This indicates whether the Override Network’s Screen Operating Hours setting is enabled. If you decide to add the operating hours for a device, this must be set as true. If false, the flag is disabled and the operating hours default to the network-level setting.
   • (Optional) screen_rotation—This flag enables you to rotate the content on your screen.
   • (Optional) venue_id—This is the vistar.venue_id located in the ad platform.
   • (Optional) tags—These are used to help you easily identify, group, and search for devices. These are comma separated values.
     
     Note: If you have existing custom parameters configured for your devices, they appear in the CSV file as additional fields.
5. (Optional) Add custom device parameters in bulk by adding the following parameter, param:{parameter_name}, in a new column. For example, you can add param:webpage.url as the parameter and https://www.google.com as the value. Learn more about device parameters.
6. Save your CSV file. Note that the CSV file can have a maximum size of 500KB and must be in UTF-8 format to upload in Fleet.

Now, complete the upload your device list procedure to finish editing your devices in bulk.

To export and edit a custom list of devices

1. Log in to Fleet at fleet.cortexpowered.com.
2. Click Devices, then Bulk Edit in the side navigation bar. The Bulk Edit Devices view appears.
3. Select the Export Custom Device Configuration option. Custom fields appear for you to select your columns and rows.
4. Click the Device Properties drop-down list and select one or more of the following options:
   • Location
   • Network
   • Is Agent
   • Tags
   • Operating Hours
5. Click the Applications Parameters drop-down list and select one or more of the parameters that you want to edit. Or, enter a string of text in the search field to find a specific parameter. See Update device parameters for more information about application parameters.
6. Click the Device Flags drop-down list and select one or more flags that you want to edit. Or, enter a string of text in the search field to find a specific device flag. See Network and device-level flags for more information.
7. Click the Target Networks & Devices drop-down list and select one or more networks and devices to edit. Or, enter a string of text in the search field to find a specific network or device. By default, _all is selected to ensure that the template includes all of your networks.
8. (Optional) Click X next to your selection in the Device Properties, Applications Parameters, Device Flags, or Target Networks & Devices drop-down lists to remove it.
9. Click Export Current Devices Config as .csv to download the existing data for your custom list.
10. Open the template and edit the fields as described in step 4 and 5 of the previous procedure (To export and edit all devices in bulk). Note that depending on your custom selection, some fields may not appear in the template.
11. Save your CSV file. Note that the CSV file can have a maximum size of 500KB and must be in UTF-8 format to upload in Fleet.

Now, complete the upload your device list procedure to finish editing your devices in bulk.

To upload your device list

1. Log in to Fleet at fleet.cortexpowered.com.
2. Click Devices, then Bulk Edit in the side navigation bar. The Bulk Edit Devices view appears.
3. Click Choose file in the Upload .csv file section and select your CSV file. Note that the CSV file can have a maximum size of 500KB and must be in UTF-8 format to upload in Fleet.
4. Click Update. Your device information is updated.

Note: If there are any errors with your CSV file, it appears in Fleet after you upload the CSV file. You can fix the errors in the CSV file, then repeat the procedure to edit devices in bulk.

Devices must be restarted for any device flag changes to be implemented.