# Groups

## Group list screen

<div align="left"><img src="/files/-LQ0P4z-3iFuEmvhyar9" alt=""></div>

![](/files/-LQ0P4z1Bib4WCb6cpAc)  represents a group of users from a single directory (created by a synchronization or defined within WorkflowGen).

![](/files/-LQ0P4z3NHVwPuQgs1ro)  represents a virtual group of users from a single directory filtered by an SQL-like query (directory filter).

### Associated users

Users are associated with a group only when the group is saved (at creation or when manually re-saved). If synchronized, the user list is refreshed at the time of the synchronization. If no synchronization has been defined for that directory, users in the virtual groups of that directory will not be updated automatically.

## Menu banner

| **Links** | **Remarks**                                    |
| --------- | ---------------------------------------------- |
| New group | Displays a blank group form to add a new group |
| Refresh   | Refreshes the group list displayed             |

## Filters

| **External filters** | **Remarks**                                           |
| -------------------- | ----------------------------------------------------- |
| Directory            | Displays the specified group directory                |
| Type                 | <ul><li>All</li><li>Directory</li><li>Query</li></ul> |

| Filter on \*      | Remarks                                    |
| ----------------- | ------------------------------------------ |
| Name              | Filters by group's name                    |
| Description       | Filters by group's description             |
| Query             | Filters by group’s query                   |
| Email             | Filters by group's email address           |
| Group code        | Filters by group's code                    |
| Display name      | Filters by group's displayed name          |
| Distinctive name  | Filters by group's distinctive name        |
| System identifier | Filters by group's system identifier (SID) |

\* A filter can be applied to part of a field.

## Group list

| **Columns**             | **Remarks**                                                                                                                                                       |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Multi-select checkboxes | <p>Actions:</p><ul><li>Activate the selected group’s members</li><li>Deactivate the selected group’s members</li><li>Delete the selected groups</li></ul>         |
| Name                    | Name of the group (a link displays the group form in edit mode)                                                                                                   |
| Description             | Description of the group                                                                                                                                          |
| Users                   | Number of users associated to the group (a link displays the corresponding users)                                                                                 |
| Directory               | <p>Group directory</p><p></p><p>✏️ <strong>Note:</strong> This column is only visible when you select <strong>All</strong> from the Directory drop-down list.</p> |

## Group screen

![](/files/-LQ0P4z51gsM1nfQXTsy)

## Group form

| **Fields**        | **Remarks**                                                                                                                                                             |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Directory         | Group directory                                                                                                                                                         |
| Name              | Unique identifier for the group in the directory (required field)                                                                                                       |
| Description       | Group description (required field)                                                                                                                                      |
| Query             | Statement allowing a group definition based on query parameters (directory filter); see below for [query examples](/admin/8.3/user-management/groups.md#query-examples) |
| (Help)            | Help on query syntax (field name list)                                                                                                                                  |
| Test              | Query syntax test and query result                                                                                                                                      |
| Email             | Group email address                                                                                                                                                     |
| Group code        | Group code                                                                                                                                                              |
| Display name      | Group displayed name                                                                                                                                                    |
| Distinctive name  | Group distinct name                                                                                                                                                     |
| System identifier | Group SID                                                                                                                                                               |
| User(s)           | Number of users associated to the group (a link displays the corresponding users)                                                                                       |
| Synchronized      | If checked, the group is synchronized                                                                                                                                   |

### Query examples

* User of a group: `{ISMEMBER(FINANCE)}`

* Users from a defined city: `CITY = 'LOS ANGELES'`

* Combinations, such as: `Country='USA'` and `{ISMEMBER(FINANCE)}`

## Deleting a group

Deleting a group does not delete the associated users.


---

# Agent Instructions: 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.workflowgen.com/admin/8.3/user-management/groups.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.