# GroupingLevel

Location: [gRPC API](https://developer.m-files.com/APIs/gRPC-API/index.md) > [Reference](https://developer.m-files.com/APIs/gRPC-API/Reference/index.md) > [Messages](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/index.md)

HTML version: https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.GroupingLevel/

Extended expression (used to describe a view level, for example).

- **Full name:** `MFiles.GroupingLevel`
- **Proto file:** [`mfiles/structs.proto`](https://developer.m-files.com/APIs/gRPC-API/downloads/proto/mfiles/structs.proto)

<a id="fields"></a>

## Fields

| Field | Type | Number | Description |
|---|---|---|---|
| <a id="f-expression"></a>`expression` | [`Expression`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.Expression/index.md) | 1 | Basic data. |
| <a id="f-show_folders_without_objects"></a>`show_folders_without_objects` | `bool` | 2 | True to show empty folders, false to hide them. |
| <a id="f-show_empty_value_folder"></a>`show_empty_value_folder` | `bool` | 3 | True to show the unset folder, false to hide it. |
| <a id="f-show_objects_with_empty_value"></a>`show_objects_with_empty_value` | `bool` | 4 | True to show the contents of the unset folder directly on this level. |
| <a id="f-show_matching_values_on_this_level"></a>`show_matching_values_on_this_level` | `bool` | 5 | True to show the matching objects directly on this level. |
| <a id="f-property_folder_filter"></a>`property_folder_filter` | repeated [`SearchCondition`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.SearchCondition/index.md) | 6 | The conditions that limit the values (property folders) of this expression. |
| <a id="f-empty_value_folder_name"></a>`empty_value_folder_name` | `string` | 7 | The name of the unset folder. If unset or an empty string, the default localized name is used. |
| <a id="f-show_only_user_selected_folders"></a>`show_only_user_selected_folders` | `bool` | 8 | True if the contents of this view level should be created on-demand only. |
| <a id="f-subfolder_algorithm"></a>`subfolder_algorithm` | [`FolderListingAlgorithm`](https://developer.m-files.com/APIs/gRPC-API/Reference/Enums/MFiles.FolderListingAlgorithm/index.md) | 9 | Folder listing algorithm used to determine matching property folders on this intermediate view level. Values: `FOLDER_LISTING_ALGORITHM_NONE` (0), `FOLDER_LISTING_ALGORITHM_TEST_EACH_VALUE_WITH_SINGLE_QUERY` (1), `FOLDER_LISTING_ALGORITHM_GET_VALUES_BY_DISTINCT_USE` (2), `FOLDER_LISTING_ALGORITHM_TEST_EACH_VALUE_WITH_SEPARATE_QUERIES` (3). |
| <a id="f-options_obsolete"></a>`options_obsolete` | `uint32` | 10 | Bit flags that provide additional information on the extended expression. |
| <a id="f-options"></a>`options` | [`EXPRESSIONEXFLAGS`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.EXPRESSIONEXFLAGS/index.md) | 13 | Bit flags that provide additional information on the extended expression. |
| <a id="f-expression_object_type"></a>`expression_object_type` | `int32` | 11 | The ID of the object type to group-by in this view level. |
| <a id="f-reference_direction"></a>`reference_direction` | `bool` | 12 | True if the result objects are referred from this view level. |

<a id="used-in-fields"></a>

## Used in fields

- [`SearchDef.grouping_levels`](https://developer.m-files.com/APIs/gRPC-API/Reference/Messages/MFiles.SearchDef/index.md#f-grouping_levels): View levels (the display hierarchy of this search).