> This page is for Itential Platform Cloud.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Manage device groups

> Create device groups from device names or Inventory Manager tags, add and remove devices, and track golden configuration and compliance plan activity for each group.

A device group is a named set of devices that golden configuration trees, compliance plans, and Studio workflow tasks target as a single unit. You can build a group from Inventory Manager tags or from device names. You can also see which trees and plans use each group and how its devices performed in their latest compliance checks.

## How device groups work with Inventory Manager tags

Keep these behaviors in mind when you build and maintain a device group:

* **Membership is a snapshot**: A group contains the devices you selected when you saved it. If tags or inventories change later in Inventory Manager, the group doesn't update. To bring a group up to date, add devices to it again.
* **Devices can come from more than one source**: One group can hold devices you selected by name and devices you selected by Inventory Manager tag, including devices from more than one inventory.
* **Access control applies**: You can only see and select the inventories, tags, and devices that your Inventory Manager permissions allow.
* **Consumers don't change**: Golden configuration trees, compliance plans, and Studio tasks use a tag-built group the same way they use any other device group.

## Before you begin

Before you work with device groups, confirm that:

* You have access to Configuration Manager.
* To build groups from tags, the devices you want are in an inventory in Inventory Manager and have tags applied. See [Tags and organization](../inventory-manager/inventory-manager-tags).
* Your Inventory Manager permissions give you access to the inventories and tags you want to use. See [Security and access control](../inventory-manager/security-access-control).

## View device groups

To see all device groups, select **Device Groups** from the Configuration Manager left navigation bar. The **Device groups** page opens with a list of every group you can access. To view device groups through the **Collection** window instead, expand the **Device Groups** navigation category using the arrow on its left and select the **View All \<#> Results** button from the bottom of the expanded list.

### Device groups page

On the **Device groups** page, use the search box above the upper-right corner of the list to find a group by name, description, OS mix, or tag. You can sort the group list by **Name**, **Status**, and **Last Run** by selecting the relevant column's header. You can also filter the list by **Status**, **OS Mix**, **Tags**, and **Last Run** by selecting the filter icon to the left of the relevant column's header.

## Create a device group

Configuration Manager provides two ways to create a device group: the **Create Device Group** panel and the **Create** modal.

> **Warning**
>
> There is no way to modify a device group's metadata, including its name and description, after creation. Ensure these fields are set as desired when creating a device group.

### Use the Create Device Group panel

The **Create Device Group** panel lets you name the group and select its devices by name or by Inventory Manager tag during the creation process. To create a device group this way:

On the **Device groups** page, select **New Device Group** in the upper-right corner of the page. The **Create Device Group** panel opens.

Enter a group name and optionally a description.

Select devices using one or both tabs:

* **Name**: Lists every device available to you, with its **Device OS** and **Source**. Search the list, or filter and sort by name, device OS, or source. Select the checkbox for each device you want to add.
* **Inventory Tags**: Select an **Inventory**, then select one or more **Tags**. The table lists the devices in that inventory that match the selected tags. To narrow the results, filter by **Device Name** or **Device OS**. Select the checkbox for each device you want to add, or select the checkbox in the header row to select every device in the list.

To add devices from another inventory, select a different **Inventory** and repeat. Devices you've already selected stay selected when you switch inventories.

> **Note**
>
> If you want to see all of the inventory tags assigned to a device, view the device's details page. See [View and manage devices](./manage-devices) to learn more.

Select **Create** in the bottom-right corner of the panel.

The new group appears on the **Device groups** page with a status of **Not Run**.

### Use the Create modal

To create a device group with the **Create** modal:

In Configuration Manager, select the **Create** (+) button at the top of the left navigation bar.

In the **Create** modal, select **Device Group** from the dropdown.

Enter a name and optionally a description.

Select the **Create** button at the bottom of the modal. The device group's details page opens.

When you create a device group using the **Create** modal, you have to add devices to the group after creation.

## Device group view

To view a group's details, select its name on the **Device groups** page. The top of the details page summarizes the group. Below the summary, the **Devices** and **Recent activity** tabs show the group's members and compliance history, respectively.

### Devices tab

The **Devices** tab lists every device in the group. From this page you can:

* **View** devices from Inventory Manager in the format `<inventory-name>::<device-name>`. Select a device's name to navigate to its device details page.
* **Remove** devices from the group using the **Remove** button under the **Actions** column.
* **Search** by name, device OS, or source, and sort or filter any column. Change the number of devices shown at once using the **Items per page** dropdown in the bottom-left corner of the page.

### Recent activity tab

The **Recent activity** tab lists each golden configuration tree and compliance plan that uses the group. A row appears as soon as you add the group to a tree or plan, even before any compliance check runs.

Compliance plans and golden configuration trees are listed in the format `Golden Configuration: <tree-name>` or `Compliance Plan: <plan-name>`. Each entry links to the golden configuration tree's details page or the compliance plan's details page. You can sort and filter the table by any column, or use the search bar above the right side of the table.

The columns show compliance details as of the most recent compliance check. If no check has been run, the **Status** column shows **Not Run**. Otherwise, it shows **Compliant** if every device is compliant, and **Non-Compliant** if even one device fails compliance. Non-compliant devices in the **Result** column include devices that failed compliance checks as well as devices that failed to connect.

The **Recent activity** tab gives summary information only. To see which devices failed compliance and which failed to connect, select the tree or plan and open its compliance report.

### Add devices to a group

To add devices to a group:

Select **Add Devices** from the upper-right corner of the page. The **Add Devices to Group** panel opens.

Select devices on the **Name** tab, the **Inventory Tags** tab, or both. Step 3 of [Use the Create Device Group panel](#use-the-create-device-group-panel) describes how to use these tabs.

Select **Add Devices** in the lower-right corner of the panel.

A confirmation message shows how many devices were added to the group.

### Remove devices from a group

Removing a device takes it out of the group only. The device stays in its inventory or source system.

* **Remove one device**: On the **Devices** tab, select **Remove** in the device's row.
* **Remove several devices**: Select the checkbox for each device, then select the delete icon above the table.

### Delete a device group

You can't delete a device group while a golden configuration tree or compliance plan uses it. Configuration Manager returns an error if you try. Remove the group from each tree and plan listed on its **Recent activity** tab first.

To delete a group, open it and select **Delete**. Deleting a group doesn't delete its devices.

## Device groups in Studio workflows

The **Create Device Group** and **Add Devices to Group** Studio tasks

have `inventoryTags` and `deviceNames` inputs

. To use the `inventoryTags` input, select an **Inventory**, then select one or more tags. When the task runs, it adds the devices in that inventory that match the selected tags.

Keep these behaviors in mind:

* **One inventory per task**: Each task covers one inventory. To add devices from several inventories, add an **Add Devices to Group** task for each additional inventory.
* **Both inputs are optional**: If you set `deviceNames`, `inventoryTags`, or both, the task adds those devices. If you leave both empty, **Create Device Group** creates a group with no devices.
* **Existing workflows keep working**: Workflows that use only `deviceNames` don't need changes.

> **Warning**
>
> If the user running the task doesn't have access to the selected inventory, the task uses a different inventory that the user can access and adds devices from it. The group can end up with devices you didn't intend to include. Make sure the account that runs the workflow has access to the inventory selected in the task.

## Upgrade behavior for Platform 6.7

Upgrading to Platform 6.7 doesn't delete any device group data, including associations with golden configurations and compliance plans. However, existing groups don't show compliance runs from before the upgrade. They show **Not Run** until a new compliance check runs, even if the group was checked previously.

## Related resources

* [View and manage devices](./manage-devices)
* [Golden Configuration overview](./golden-configurations/overview)
* [Create a compliance plan](./compliance-plans/create)
* [Tags and organization in Inventory Manager](../inventory-manager/inventory-manager-tags)