Firstly, we need to discuss some important Ubidots definitions of device and variables.
What is a Device Name? As the name implies is the name of the device. You can assign the name of your preference to make it friendlier.
What is a Variable Name? As the name implies is the name of the variable. You can assign the title of your preference to make it friendlier.
What is a Device Label? Also referred to as an API Label, the device label is the single and unique label of your Device that is randomly assigned to your device by Ubidots. Check out our API docs to learn how to send data to Ubidots
What is a Variable Label? Also referred to as an API Label, this is a single and unique label of your variable that is randomly assigned to your device by Ubidots.
What is the Differences?
The differences between Names and Labels are simples:
- The device/variable name is show in your device section of your Ubidots Application. To make it friendly and looks better we recommend to our user assign a friendly name.
Before modifying names (not friendly)
After modifying the names (friendly)
- The device/variable label is the unique label, but what does this means? In order for your device and sensor variables to remain only for you, we assign each a specific code that is interpreted by Ubidots application as single and unique to only one device and variable. This is what allows you to transfer data between the device and ubidots. It is not recommended to change the Device Label or Variable Label as any adjustments to these inputs will result in errors and faulty data transmission.
NOTE: Make you sure your device is using the same label as the one on Ubidots if not you will not be able to manage the data in your application.
Simply, the difference between Device Names and Device Labels is that Device Names can be edited while Device Labels should not be edited due their unique coding.
Following these steps below to assign a friendly name to your devices and variables:
1.- Go to your Ubidots account.
Click here for Educational Licenses
Click here for Business (Industrial) Licenses
2.- Go to the device tab to see your connected devices. Here you can change the Device Name (not the device label), but first you have to verify if you're able to edit the device information.
3.- Select the device you wish to give a friendly "Device Name" in your dashboard and ensure the following pencil icon is highlighted. If it is not, simply click the icon to activate text altering.
4. Now, you are able to modify the device name double-clicking the device's name:
- Before :
NOTE: You can change the Device Name and Variable Name to a friendly user selected name based on your own nomenclature. The Device Label is not to be adjusted as this is linked to your coding. If you wish to adjust the Device label, you will need to modify the device label across all internal coding as well. This is not recommended unless you have experience with coding and integrations.