---
title: Tags (Administration)
id: "en:tpm:admin:tags.adoc"
site: en
component: tpm
module: admin
version: 3.0
lang: en
url: "https://help.rtlscloud.io/en/tpm/3.0/admin/tags.html"
source_repo: "https://github.com/iot-invent/rtlscloud-tpm.git@3.0.x"
source_path: docs/en/modules/admin/pages/tags.adoc
---

# Tags (Administration)

The same tag list as in the tenant work area, but across **all tenants**. This is where a cloud administrator assigns a newly appeared device to a tenant.

## What This View is For

A device reporting for the first time lands in the default tenant and is therefore invisible in any tenant work area. This view is the only place it can be found.

The usual procedure for a new shipment: filter by IMEI or by **Created at**, select the devices and assign them to the tenant through the context menu. The tenant itself then takes over the group assignment.

## Reference

![Tags (Administration)](_images/tpm_app_admin_tags.png)

| Module | Description |
| --- | --- |
| ![refresh](_images/refresh.svg) Refresh | Reloads the list |
| ![filter](_images/filter.svg) Filter | Tag Id or name, tenant, IMEI, FW revision |
| ![plus](_images/plus.svg) New | Creates a tag manually |
| ![edit](_images/edit.svg) Edit | Opens the selected tag for editing |
| ![delete](_images/delete.svg) Delete | Removes the record |
| ![info](_images/info.svg) Info | Number of tags shown, at most 1000 |

## Display

The columns match those of [Tags](../tags.md), plus:

| Column | Description |
| --- | --- |
| Tenant | The tenant the tag is assigned to. The default tenant means: not yet assigned |

## Filter

| Filter | Description |
| --- | --- |
| Search | Tag Id or name |
| Tenant | Restriction to one tenant. The way to find every device not yet assigned |
| IMEI | Search by the cellular hardware identity. Useful when an IMEI list for a shipment is available |
| FW revision | Restriction to one firmware version. Useful for finding devices that need an update |

## Assigning a Tenant

Select one or more tags and use **Assign new Tenant**. The tag is moved together with its complete history; recorded decisions are preserved.

Note: after the assignment the tag is **not yet** assigned to any group, so its events still do not reach any third-party system. That second step happens in the tenant’s work area — see [First Steps](../firststeps/firststeps.md).

## Decommissioning a Device

If a device should no longer be processed, set **Active** to No. Its events are then rejected.

> **IMPORTANT:** Deleting the record does not help — if the device reports again, it is recreated, again in the default tenant. Only deactivation has a lasting effect.