> 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/group/group-page-cockpit-view.md).

# Group Page - Cockpit View

<figure><img src="/files/kW2WVdAl6UMGe9VhsxWz" alt=""><figcaption><p>Group's Page - Cockpit Menu</p></figcaption></figure>

### **Access the Groups Page**

1. **Open the Cockpit Menu**\
   From the left sidebar, click on the **Cockpit** menu to expand the available sections.
2. **Click on "Groups"**\
   Select **Groups** to open the dedicated page.
3. **View Group Structure**\
   Here, you can **visualize all existing groups** or **only the groups assigned** to your user role, depending on your access level.

<figure><img src="/files/rf88WoEMR2tvopFDNY1d" alt=""><figcaption><p>Access to the Group's Page </p></figcaption></figure>

### **Group Page Functions**

In the **top-right corner** of the **Groups page**, **Super Admins** or users with **granted permissions** will find all available group management functions:

#### **Filter by Group Type**

You can apply the following filters:

**Group Type:**

* **All Groups** – Displays every group and subgroup.
* **Top-Level Groups** – Shows only the main parent groups.
* **Subgroups Only** – Displays only the subgroups without parent groups.

**Group with Devices Filter:**

* **"Group with no devices" ON** – Only shows groups that currently have **zero devices** assigned.
* **"Group with no devices" OFF** – Shows **all groups**, regardless of whether devices are assigned or not.

#### **Create Group**&#x20;

<https://docs.g-iot.io/platform-user-guide-book/group/create-groups>

Click on **Create Group** to:

* Manually create a new group.
* Or **upload a list of devices via CSV**.

  > The CSV file must contain a single column, starting from cell **A1**, with each row listing one **Device ID**.

#### **Manage Group Operations**

&#x20;[**https://docs.g-iot.io/\~/revisions/uNl6q0i0bNyEz2E3VbFf/platform-user-guide-book/group/assign-device-to-group**](https://docs.g-iot.io/~/revisions/uNl6q0i0bNyEz2E3VbFf/platform-user-guide-book/group/assign-device-to-group)

Click the **Manage** icon to:

* **Assign Devices**: Add selected devices from one group to another (device will belong to both).
* **Move Devices**: Move devices to a new group (they will be removed from the source group).

  > If the source group becomes empty, you’ll be prompted to **delete** it.
* A clean UI shows both **source** and **target groups** side-by-side for easy management.

#### &#x20;**Switch View**

[**https://docs.g-iot.io/\~/revisions/uNl6q0i0bNyEz2E3VbFf/platform-user-guide-book/group/group-page-card-and-tree-view**](https://docs.g-iot.io/~/revisions/uNl6q0i0bNyEz2E3VbFf/platform-user-guide-book/group/group-page-card-and-tree-view)

Toggle between:

* **Card View**: Quick overview with group stats.
* **Tree View**: Visualize the full **group hierarchy**, including all **subgroups**.

#### **Sort Groups**

Sort the list by:

* **Creation Date**
* **Alphabetical Order**

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcYsvk5CEtE8ia36JQ7SHkX8WkzTEKxebVLTRSJ9hQ5lnm6QC5mlGj78jTKbXtXP0LUmnduibsqYuFPuaOG5gA2D3sjVo43Tj9ZskZSOFZDleUgsoPjnnnncT9j2lFyn94qFgcjKg?key=M-g4csUEzYvWKn331EzU-Woy" alt=""><figcaption><p>Group Page Fuctions</p></figcaption></figure>

### Group Card Options

Each group card includes a **⋮ (ellipsis)** menu offering several management actions. These are available **only** to **Super Admins** or users with granted permissions.

**Manage**

* **Assign or Remove Devices** – Add or remove devices from the group.
* **Move Devices Between Groups** – Transfer selected devices to another group.
* **Edit Group Name and Description** – Adjust key identifiers for organizational clarity.

**Edit**

* **Group Name** – Rename the group.
* **Group Description** – Add or update a description for context.
* **Group Icon and Color** – Select a visual identity for the group.
* **Upload Avatar** – Optionally upload a custom image or logo for the group card.

**Delete**

* **Permanently deletes the group**, including:
  * All of its **subgroups**
  * All **device assignments**

**Note:** This action is **irreversible** and must be used with caution.

{% hint style="warning" %}
**Permission Note;** Only Super Admins or users with explicitly granted permissions can access Manage, Edit, or Delete functions.
{% 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:

```
GET https://docs.g-iot.io/platform-user-guide-book/group/group-page-cockpit-view.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.