> For the complete documentation index, see [llms.txt](https://docs.g-iot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.g-iot.io/platform-user-guide-book/administration/subtenant-device.md).
# Subtenant Device
The **Subtenant Device** section provides Super Admins and permitted roles with an overview and full control of device distribution across Subtenants. This feature allows centralized monitoring and management of which devices are assigned to each Subtenant, and ensures transparent tracking of asset ownership and group allocations within each tenant structure.
From this section, users can:
* Select a Subtenant and view the devices currently assigned to it.
* Manage individual device assignment to and from Subtenants.
* Assign entire groups — and their associated devices — to a selected Subtenant.
#### Steps to Access the Logs Page
1. **Go to Cockpit Menu**\
Navigate to the sidebar and click on the **Cockpit** menu.
2. **Click on Administration**\
Within the Cockpit menu, select the **Administration** section.
3. **Select Logs**\
Click on **Logs** to open the page.
Once opened, the page displays a chronological list of all tenant-related activities. Selecting a log entry opens the detailed log view with additional metadata and contextual information.
#### **Page Overview and Specific Functions**
**1. Subtenant Selection Panel (Left Column)**
* Lists all existing Subtenants.
* Click on a Subtenant to display its associated device data.
**2. Device Assignment Section**
* Shows the complete list of devices currently assigned to the selected Subtenant.
* Allows manual assignment or unassigned of individual devices.
**3. Group Assignment Panel**
* Enables the assignment of entire **Groups** to the Subtenant.
* All devices within the selected groups
* will be assigned automatically to the Subtenant.
* Useful for organizing large sets of devices under structured Subtenant ownership.
{% hint style="info" %}
#### Only **Super Admins** can modify device or group assignments across Subtenants. All changes apply instantly and reflect across the platform.
{% endhint %}
{% hint style="danger" %}
#### **Attention**
When assigning a **Group** to a Subtenant, the action will only succeed if **all devices** within that group are **exclusively** assigned to that group.
If **any device** in the selected group is also assigned to **another group**, the platform **will block** the assignment to avoid conflicts in device ownership across Subtenants.
**Tip:** Before assigning, verify that all devices in the group belong **only** to that group or consider cleaning up group overlaps.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.g-iot.io/platform-user-guide-book/administration/subtenant-device.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.