Create session subgroups

1. Click a session type in the navigation bar

2. Click Create Session Group

In the session groups panel, click the + Create Session Group link. The Create Session Group modal will open.

3. Enter a name for your subgroup

This name will be displayed on the Host page.

4. Enter a subgroup expression

To split your sessions into subgroups, click the + icon next to the Subgroup Expressions field.

Select an expression from the list. You can hover over an expression to see a definition of it.

When you've decided on an expression, click to add it to the subgroup filter box.

5. (Optional) Click the Create another checkbox

If you’d like to create another session group or subgroup after your current group, make sure this checkbox is checked.

6. Click Create to complete your session group

Verify that your session group is correctly populated with your sessions.

Subgroup tip: Using IIF

When building subgroups, the IIF function can be extremely useful. For example, the subgroup with a filter of IIF(GuestConnectedCount > 0, 'Connected', 'Disconnected') will create two groups: Connected and Disconnected. Machines with a GuestConnectedCount greater than 0 will appear in the Connected subgroup, while the remaining machines will be grouped in the Disconnected subgroup.

Subgroups returning (empty)

If your subgroup is returning a subgroup named (empty), you might be trying to use an expression like GuestConnectedCount = 1and expecting  two groups: True and False. This behavior changed in version 2023.3. If you want to have the expression to return True and False subgroups, try constructing your subgroup expression using the IIF function as described above.

Variables are not supported

Variables, such as $XDAYSAGO, are not supported in subgroup filters. 

Subgroup examples