# group_item_label

<br />

## Usage

```
view: view_name {
  dimension: field_name {
    group_item_label: "desired label"
  }
}
```

|---|---|
| Hierarchy [View File](https://docs.cloud.google.com/looker/docs/reference/param-view) [`view`](https://docs.cloud.google.com/looker/docs/reference/param-view-view) [Field Type](https://docs.cloud.google.com/looker/docs/reference/param-field) `group_item_label` | Possible Field Types Dimension, Dimension Group, Filter, Measure <br /> Accepts A string <br /> |

## Definition

In cases where you've used the [`group_label`](https://docs.cloud.google.com/looker/docs/reference/param-field-group-label) parameter to combine fields into custom groups in a view's field picker, you can also use the `group_item_label` parameter for each of the grouped fields to customize how the individual fields are shown in the field picker.

For example, you can add the `group_label` to a set of fields like this:

    view: accounts {
      dimension: shipping_city {
        sql: ${TABLE}.shipping_city ;;
        group_label: "Shipping Info"
      }
      dimension: shipping_state {
        sql: ${TABLE}.shipping_state ;;
        group_label: "Shipping Info"
      }
      dimension: shipping_street {
        sql: ${TABLE}.shipping_street ;;
        group_label: "Shipping Info"
      }
    }

These fields will now be combined into an expandable **Shipping Info** section in the field picker.

But since these fields are shown under the expandable **Shipping Info** section, they don't need to have "Shipping" in their individual labels as well. So you can add the `group_item_label` parameter to each of the grouped fields:

    view: accounts {
      dimension: shipping_city {
        sql: ${TABLE}.shipping_city ;;
        group_label: "Shipping Info"
        group_item_label: "City"
      }
      dimension: shipping_state {
        sql: ${TABLE}.shipping_state ;;
        group_label: "Shipping Info"
        group_item_label: "State"
      }
      dimension: shipping_street {
        sql: ${TABLE}.shipping_street ;;
        group_label: "Shipping Info"
        group_item_label: "Street"
      }
    }

The `group_item_label` displays only in the field picker. In the Data section of an Explore and in any visualizations, Looker displays the field's name or label as normal.