> 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/create-groups.md).
# Create Groups
{% hint style="danger" %}
**Permission Note;** Only Super Admins or users with explicitly granted permissions can access Manage, Edit, or Delete functions.
{% endhint %}
Groups are a powerful way to organize and manage devices efficiently within the platform. By categorizing devices into groups, you can streamline configurations, apply rules, and analyze data specific to subsets of your devices. Groups help maintain clarity and efficiency, especially when managing large numbers of devices.
### Create a Group
Creating a new group on the GIOT platform helps you organize and manage devices effectively. The ability to create groups is now available again from the **Assets View**, but with access limitations depending on user roles.
***
{% hint style="success" %}
**Who Can Create Groups?**
* **Super Admins** or users with explicitly granted permissions can create groups from multiple areas of the platform.
* **Restricted Users** can only create **subgroups** within their assigned group structure (i.e., under existing groups they have access to).
{% endhint %}
***
### Where to Create a Group (Super Admin)
Super Admins can create new groups from three locations:
**1. Group Index – Card View**
*
```
```
* Go to **Cockpit Menu > Group**.
* Switch to **Card View**.
* Click the **“Create Group”** button in the top right corner.
**2. Group Index – Tree View**
* From **Group Tree View**, click the **“Create Group”** button at the top.
* This allows you to add a top-level group to the hierarchy.
**3. Group Index – Tree View (⋮ Ellipse Menu)**
* Hover over a **parent group**, click the **three dots (⋮)**.
* Select **“Create Subgroup”**.
* This lets you create a **subgroup within a group**, respecting its hierarchy.
***
#### Add Devices via CSV Upload
During group creation, it is also possible to add devices in bulk by uploading a **CSV file** containing the list of device serial numbers. This feature simplifies and speeds up group setup when working with a large number of devices, eliminating the need to manually add each device individually. Once the file is uploaded, all valid devices are automatically associated with the newly created group.
***
### Group Creation for Restricted Users
Restricted users **cannot use the main “Create Group” buttons**, but they **can create subgroups** using:
* **Group Index – Tree View**
* Click **⋮ on a group** they are assigned to
* Select **“Create Subgroup”**
This ensures that restricted users stay within their allowed structure and cannot create groups outside their permission scope.
***
{% hint style="info" %}
**Regular Create Group buttons** will place the new group in the general group structure, which **may not be visible** to restricted users.\
**Subgroup creation via the three-dot menu** ensures the group is placed **within accessible areas** for restricted profiles.
{% 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/create-groups.md?ask=
```
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.