Tags System

Tags System

Tags are a flexible and powerful way for organizing and labeling your assets within TagoIO, allowing you manage access and identify key components such as Devices, Actions, Analysis, Dashboards, Users & Access rules. 

Operating like key-value pairs, tags enable you to assign relevant metadata such as names, descriptions, categories, locations, customers, products, and more, to your assets.

1. How to use tags

Tags can be assigned to a wide range of components within TagoIO, and are typically accessible through a designated "Tag" tab when configuring assets that support label assignment



Each tag have 2 configurable parameters:
  1. Key: name of the parameter used as reference, you can also select an existing key.
  2. Value: the value of the parameter that you want to assign to your asset.
The main usage of tags is to identify and manage access of the assets. For instance, you can filter out the assets by using API List endpoints or SDK methods and get a list of devices that belong to a specific customer or product by using the tag filter parameter.
‚Äč
Check out our API and SDK documentation.
The maximum number of Tags per asset is 30.
If you attempt to add additional items beyond the limit, a notification will appear indicating that the maximum capacity has been reached.

2. Where to use

You can set your tags in different ways depending on your application design. Here are some TagoIO features that make extensive use of this system:

2.1. Access Management

You can use tags to manage access from users to devices, dashboards and even other users. This allows for scalability and easy management of access rules. For example, you can create a user group with a tag like `role: Manager` and grant them access to all devices with the tag `customer: ACME Inc.`.



Read more about the Access Management feature.

2.2. Blueprint Dashboards

This dashboard utilizes tags to enable users to seamlessly switch between devices that provide data to the dashboard. By incorporating tag-based functionality, the dashboard can be used across multiple devices, making it a highly versatile and flexible tool. The dashboard identifies selectable groups of devices based on their assigned tags, enabling users to quickly and easily switch between data sources as needed.

For example, you can create a blueprint dashboard with a tag like `device_type: Temperature Sensor` and allow users to choose any device with that tag from a dropdown menu.



Read more about Blueprint Dashboards.

3. How to manage your Tags

Tags can be managed from different sources:
  1. TagoIO Interface: You can manually add or edit tags from the TagoIO interface by clicking on the asset and then on the Tags tab.
  2. Analysis SDK: You can programmatically add or edit tags from an analysis script by using the SDK methods available for each asset type. For example, you can use `account.devices.edit()` or `account.actions.edit()` methods.
  3. TagoIO API: You can also use the REST API endpoints for each asset type to add or edit tags by sending HTTP requests with JSON payloads containing the tag information.



    • Related Articles

    • Grouping Dashboards

      You can group related dashboards using dashboard tags. To do so, go to “Dashboard”, click on the gear icon to edit it, then on the section “Tags” create a new tag. After that, on the section “Group dashboards using Tags” select the grouping tag. To ...
    • Blueprint Devices

      Blueprint Devices are dynamic Devices available on Blueprint Dashboards. They can be changed by the user in realtime, and by doing so, the Dashboard will reload the data for the Widgets that use them. You can change the Blueprint Devices by selecting ...
    • Managing Devices

      Using the account-token, you can manage your devices through API requests. It’s possible to create, edit, delete, and get info of it. Create Create a device through POST method. POST - https://api.tago.io/device Request { "name": "My first device", ...
    • Tables

      Table widgets present your data in a tabular way. You can also allow users to change values on the cells, delete rows, and more. There are two types available: the Static Table, Dynamic Table and the Device List. Static Table It is one of the special ...
    • Adding devices with connectors

      Connectors enables you to create a device with built-in behaviors that allow it to communicate with a Network very easily. When creating devices at TagoIO, it is important to know that there are different ways to allow them to send & receive data ...
        Take a look at our updated roadmap here!
          What would you like to see on TagoIO?

            Future and past Webinars