> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://docs.omni.co/feedback

```json
{
  "path": "/modeling/measures/parameters/group-label",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# group_label

> Group related measures together under a label in the workbook field browser for cleaner organization and easier discovery.

## Limitations

**[Dimensions](/modeling/dimensions) and [measures](/modeling/measures) can't be grouped together.** Applying the same group label to a dimension and a measure will result in two groups displaying in the field browser, not one group with both fields.

## Syntax

```yaml theme={null}
<measure_name>:
  group_label: <group_name>
```

## Properties

<ParamField path="measure_name" type="object[]">
  The name of the measure. Measure names must:

  * Be unique within the view
  * Start with a letter
  * Contain only alphanumeric characters and underscores
</ParamField>

<ParamField path="group_label" type="string">
  Unquoted text specifying the group under which the field should appear in the field browser. Use the greater-than symbol (`>`) with whitespace on either side to create nested group hierarchies. Refer to the [Organize fields with nested groups guide](/guides/modeling/nested-field-groups) for more information and examples.
</ParamField>

## Examples

```yaml title="Group order_count under Important Fields" theme={null}
order_count:
  group_label: Important Fields
```

**Group measures in a `support_tickets` view**

<Tabs>
  <Tab title="YAML">
    ```yaml theme={null}
    first_response_breach_by_day:
      group_label: SLA breaches > First response

    first_response_breach_by_month:
      group_label: SLA breaches > First response

    breach_resolution_by_day:
      group_label: SLA breaches > Resolution

    breach_resolution_by_month:
      group_label: SLA breaches > Resolution
    ```
  </Tab>

  <Tab title="Field browser result">
    ```markdown theme={null}
    ▾ SLA breaches
      ▾ First response
          first_response_breach_by_day
          first_response_breach_by_month
      ▾ Resolution
          breach_resolution_by_day
          breach_resolution_by_month
    ```
  </Tab>
</Tabs>
