> 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/assign-devices-to-a-group.md).

# Assign devices to a group

### Assign or Move Devices to a Group

Whether you're organizing newly onboarded devices or reorganizing your infrastructure, you can **assign** or **move** devices to a specific group directly from the **Assets View**.

<figure><img src="/files/IvlucwtjTEY1KczxCn3X" alt=""><figcaption><p>Assign Devices to a Group</p></figcaption></figure>

### Steps to Assign or Move Devices to a Group

1. **Go to Assets View**\
   From the sidebar, click on **Assets View**.
2. **Open Groups Page**\
   Click on **Groups**, then&#x20;
3. **Select the group you** wish to add devices to.
4. **Open Group Management Menu**\
   On the group's card, click the **ellipsis (⋯) icon** in the top-right corner.
5. **Click Manage**\
   From the dropdown, choose **Manage**.
6. **Open Device Assignment**\
   Inside the Manage menu, select **Device Assignment**.
7. **Browse or Search Devices**
   * A list of all available devices will appear.
   * Devices already assigned to this group will be **highlighted in green**.
   * Use the **scroll** function or **search bar** to find a specific device by ID or name.
8. **Select Devices**
   * Click the checkbox next to one or more devices to select them.
9. **Choose Action: Assign or Move**

   * **Assign**: Adds the selected device(s) to this group **without removing them** from any other group they are already part of.

   * **Move**: Transfers the device(s) to this group **and removes them** from any previously assigned group(s).

   > **Note:** If the device is **newly added** and has **not yet been assigned** to any group, both **Assign** and **Move** will result in the **same outcome** — assigning the device to this group.
10. **Confirm the Action**
    * Complete the process and the device(s) will now appear in the selected group.

{% hint style="info" %}

* Use **Assign** when a device should be visible in **multiple groups** (e.g., for shared management).
* Use **Move** when a device should belong to **only one group** and be removed from others.
* Group assignments help structure device visibility and dashboard views efficiently, especially in large-scale deployments.
  {% endhint %}

{% hint style="warning" %}
Only when creating a new group, it is possible to add all devices in one click by uploading a **CSV file**; see the **Create New Group** page for details.
{% 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/group/assign-devices-to-a-group.md?ask=<question>&goal=<endgoal>
```

`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.
