Start Free Trial

Platform Documentation

Tags

Tags are simple key:value labels you attach to devices so you can group, find, and filter them. For example, Location:Los Angeles or floor:3 can group devices by site, role, owner, or another category. Create a tag once, then reuse it across many devices.

Tags are reusable labels. A tag exists at the account or application level. It has a Tag Name and Tag Value. You can assign the same tag to many devices and use it to filter the Devices list. Devices are currently the only items you can tag.
Diagram: a single Tag made of a key and a value, for example Location colon Los Angeles, is assigned to several devices through a many-to-many link. The same tag then appears as a filter on the Devices list, narrowing it to just the devices that carry that tag.
Define a key:value label once, assign it to many devices, and use it as a filter.

Quick start

Use these steps if you are already familiar with NEQTO.ai.

  • 1
    Open Tag Management and click Create Tag. Enter a Tag Name, such as Location. Choose a Type, which defaults to String, and enter a Tag Value, such as Los Angeles.
  • 2
    Open an existing device and select the tag from the Tags field in General Info. One device can have many tags.
  • 3
    Go to the Devices list and use the Tags filter to narrow it down. Pick several tags and the list shows only devices that have all of them.

What a tag is

Every tag has a Tag Name, Type, and Tag Value. All three are required. The Tag Name is the key. The Type controls how the platform stores and validates the value. Choose String, Float, Int, Boolean, Array, or JSON. The Value field changes to match the Type. Only String values accept free-form text. The platform validates the other Types when you save.

Part UI label Required Limit
Key Tag Name Yes Up to 25 characters.
Type Type Yes One of String, Float, Int, Boolean, Array, JSON (default String).
Value Tag Value Yes String up to 25 characters; Array and JSON up to 500; Boolean is a toggle. Int and Float are limited by the size of the number rather than the number of characters. See the note below this table.
  • Free-form text. The Tag Name and String values accept any text up to the limit. The platform validates the other Types as described below. It trims leading and trailing spaces.
  • Uniqueness. You cannot create two identical tags in the same scope. A tag is a duplicate when its Tag Name, Type, and Tag Value match an existing tag in the same account and, when set, the same application. The same name and value can exist as different Types. For example, Reading:1 can be both an Int and a String. Creating a duplicate returns “Tag with this key and value already exists for this organization.”
  • Reuse the same key. Because the Tag Value is part of a tag’s identity, Location:Los Angeles and Location:Tokyo are two separate tags. That is the intended way to build out a dimension like “Location”.
What each Type accepts. Spaces and punctuation are fine in a Tag Name and in a String value. Keep names short and consistent. The platform validates the Tag Value against its Type, and each Type has different limits:
  • String. Free-form text up to 25 characters.
  • Int. A whole number limited by its value rather than its character count. The largest value is about 9 quadrillion, exactly 9007199254740991. The same limit applies to negative values.
  • Float. Any decimal the platform can represent, up to about 1.8 × 10³⁰⁸. A long decimal may be accepted when a whole number with the same number of characters is not.
  • Boolean. A toggle with a value of either true or false.
  • Array and JSON. Valid JSON up to 500 characters and at most 10 levels deep. The platform rejects unsafe keys such as __proto__.
A long decimal is rounded when it is saved. A Float keeps about 17 significant digits. If you enter a longer value, the platform stores the nearest value it can represent. For example, 3.14159265358979311599796346854 is stored as 3.141592653589793. The tag still saves, but its stored value differs from the value you entered. The platform shows very large or very small numbers in scientific notation. To keep a number exactly as entered, use a String tag.
Number validation messages can be misleading. A whole number above the Int limit returns Value must be a whole number. This can happen even when the value is a whole number because it is too large. A decimal above the Float limit returns Value must be a number. Use a smaller number or store the value as a String.

Tag Management

Use Tag Management to create, edit, and delete tags. The page title is Tag Management, and its description is “Tags help you organize and filter your devices more easily.”

Tag Management list shown as a table. Columns are Tag Name, Tag Value, Type, Created on, Account, and Application. A search box sits above the table, a Create Tag button is in the header, and each row has an actions menu with Edit and Delete.
The Tag Management list. Each row is one key:value tag you can reuse across devices.

The list view

Column What it shows
Tag Name The key, shown in the highlight colour.
Tag Value The value.
Type The value’s data type: String, Float, Int, Boolean, Array, or JSON.
Created on The date the tag was created.
Account The account the tag belongs to.
Application The application the tag is scoped to, or a dash for account-level tags.
  • Search filters the list by Tag Name or Tag Value. Matching is case-insensitive and can occur anywhere in the text.
  • Sort by any column, including Created on, Account, and Application.
  • Paginated at 10 rows per page by default.
  • Column widths are resizable and your choice is remembered.

Account-level vs. application tags

Tag Management appears in two places. Each has a different scope:

Where you open it What you see New tags are
The top-level Tags page Only account-level tags (not tied to any application). Account-level.
Inside an application That application’s tags plus the account-level tags. Scoped to that application.
Tag scope controls where you can use it. A tag created inside an application is visible only within that application and its device tools. Account-level tags are visible everywhere. To use a tag across all applications, create it from the top-level Tags page.

Create a tag

Create Tag modal with three fields: Tag Name with placeholder text reading e.g. comma Location, a Type selector set to String, and Tag Value with placeholder text reading e.g. comma Los Angeles. Buttons read Cancel and Create.
Creating a tag. Tag Name, Type, and Tag Value are all required.
  • 1
    Click Create Tag.
  • 2
    Enter a Tag Name, choose a Type, and enter a Tag Value. The default Type is String. The Value field changes with the Type. Int and Float use a number field, Boolean uses a true or false toggle, and Array and JSON use a JSON editor. Tag Name is limited to 25 characters. A String value is limited to 25 characters, and Array or JSON is limited to 500. Int and Float are limited by value rather than character count. See What a tag is for the numeric limits.
  • 3
    Click Create. The platform shows Tag created successfully and adds the tag to the list.
Tags empty state showing a heading No tags created yet, the line Start organizing your devices with custom tags, and a Create Tag button with a plus icon.
The empty state includes a Create Tag button.

Edit a tag

Use the row’s actions menu and choose Edit. You can change the Tag Name, Type, and Tag Value. The same length and uniqueness rules apply. Editing a tag updates every device that carries it.

Delete a tag

Delete Tag confirmation dialog. It asks Are you sure you want to delete the tag, names the tag as key colon value, and warns This will unassign it from all devices. Buttons read Cancel and Delete.
Deleting a tag also removes it from every device it was on.

From the actions menu, choose Delete. The confirmation warns “This will unassign it from all devices.” Deleting a tag detaches it from every device that had it. It does not delete the devices.

Permissions. Creating, editing, and deleting tags are separate permissions. If your role lacks them, the Create Tag button and the Edit/Delete actions do not appear. Read access is enough to see and filter by tags.

Assigning tags to devices

Assign tags from an existing device’s General Info section. The Add Device wizard does not include a Tags field. It only lets you choose a device endpoint and detect the device.

When adding a device

The current Add Device wizard does not include a Tags step. It walks you through choosing a device endpoint and detecting the device. Assign tags after the device exists.

On an existing device

Device detail General Info tab showing a Tags field. Assigned tags appear as info-coloured badges, and a searchable input lets you add more tags or create a new one inline when no match is found.
General Info shows assigned tags as badges and lets you add or remove them.

Open a device and go to General Info. The Tags field shows what is assigned and lets you add or remove tags. If none are assigned it reads “No tags assigned”.

Create a tag on the fly. If you search the device’s Tags field and nothing matches, you can create and assign a tag without leaving the device. If you are working inside an application, the new tag is scoped to that application.
  • Tags are many-to-many. A device can have many tags, and a tag can be on many devices. The platform shares the tag instead of copying it, so edits update every assigned device.
  • One assignment per pair. A given tag can be on a device only once; you cannot add the same tag twice to one device.
  • Removing a tag from a device only detaches it from that device. The tag itself stays in Tag Management for reuse.

Filtering devices by tag

Use the Devices list to filter devices by their assigned tags.

Devices list with a Tags column. Each device shows its tags as small badges with the key in a lighter shade above the value, displaying up to three tags and a plus N more indicator for the rest. A Tags filter control above the list lets you pick one or more tags to narrow the table.
The Devices list. The Tags column shows each device’s labels, and the Tags filter narrows the list.
  • Tags column. Each device row shows its tags as badges, with the key above the value. If a device has more than three tags, the remaining tags collapse into a +N more indicator.
  • Tags filter. A filter control above the list lets you choose one or more tags. The options are your existing tags, shown as key:value.
  • Multiple tags use AND. Select several tags and the list shows only devices that have every selected tag. To see devices matching either tag, filter one at a time.
  • Shareable URL. The active tag filter is stored in the page address as a tags parameter. You can bookmark or share the filtered Devices view, and it reopens with the filter applied.
The Tags filter depends on the Tags column. The filter appears only when the Tags column is visible and at least one tag exists. If the column is hidden, use the column-visibility control to show it.

What tags affect

Tags currently apply only to the areas listed below.

Area Do tags apply?
Tagging devices Yes. Devices are the only entity you can tag.
Filtering the Devices list Yes. The main use of tags.
Endpoints, dashboards, alerts, maps, analytics No. These are not tagged and are not grouped or scoped by tags today.
Application scoping Indirect. A tag can be account-level or scoped to one application, which controls where it is offered, but a tag does not assign a device to an application.
Not a hierarchy or a search syntax. Tags are flat key:value pairs. There are no nested tags, no wildcard matching, and no free-text tag query. To organize across a dimension, reuse one Tag Name with different values, such as site:warehouse-A and site:warehouse-B.

Limits and other details

A Tag Name holds up to 25 characters, and each Type caps its value differently. Deleting a tag unassigns it from every device without deleting the devices.

Limit / behavior Detail
Tag Name length 1 to 25 characters, required.
Value type One of String, Float, Int, Boolean, Array, JSON (default String). Int/Float must be numbers; Array/JSON must be valid JSON.
Tag Value limit Required, and set by the Type. String: up to 25 characters. Int: a whole number up to about 9 quadrillion, exactly 9007199254740991 (or the same figure negative). Float: any decimal up to roughly 1.8 × 10³⁰⁸, kept to about 17 significant digits and rounded beyond that. Boolean: true or false only, set with a toggle. Array and JSON: valid JSON up to 500 characters, at most 10 levels deep.
Uniqueness The full Tag Name + Type + Tag Value must be unique within its scope (account, and application when set).
Tags per device No fixed cap; the list view shows the first three and folds the rest into “+N more”.
Scope Account-level (visible everywhere) or application-scoped (visible inside that application plus account-level tags).
Delete behavior Unassigns the tag from all devices. Devices are not deleted.
  • Use consistent Tag Names. Choose names such as Location, Site, Owner, or Role, and keep their values consistent. This makes the Devices filter easier to use.
  • Choose the correct scope. Create shared account-level tags from the top-level Tags page. Create application-specific tags from inside the application.
  • Editing updates every assignment. Renaming a tag changes it on every device that carries it.
  • Filtering is AND. More selected tags means fewer matching devices, not more.

Start Free Trial