> For the complete documentation index, see [llms.txt](https://docs.advantys.com/workflowgen-administration-module-reference-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.advantys.com/workflowgen-administration-module-reference-guide/7.21.0-10/user-management/groups.md).
# Groups
## Group list screen
 represents a group of users from a single directory (created by a synchronization or defined within WorkflowGen).
 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 | |
| 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 | Actions:
- Activate the selected group’s members
- Deactivate the selected group’s members
- Delete the selected groups
|
| 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 | Group directory
✏️ Note: This column is only visible when you select All from the Directory drop-down list.
|
## Group screen
## 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](/workflowgen-administration-module-reference-guide/7.21.0-10/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.
