group_label

Limitations

Dimensions and 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

<dimension_name>:
  group_label: <label_text>

Properties

dimension_name

object

The name of the dimension. Dimension names must:

Be unique within the view
Start with a letter
Contain only alphanumeric characters and underscores

group_label

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 for more information and examples.

Date dimensions

When you apply a group_label to a date dimension, all timeframe variations (day, week, month, year, etc.) automatically nest under the parent field name within that group. For example:

Parent date field with a group label

created_at:
  group_label: Important Dates

In the field browser, this renders as:

▾ Important Dates
  ▾ Created At
      Created At Date
      Created At Week
      Created At Month
      Created At Year
      ...

This keeps related timeframes organized together while allowing you to categorize date fields into logical groups. If you want to have specific timeframes as standalone dimensions (not under a group), specify timeframes: [].

Examples

Grouping fields

name:
  group_label: Important Fields

Nesting under a timeframe group

created_at: {}

example_new_time:
  sql: "other_time"
  group_label: Created At
  timeframes: [minute]

Standalone date dimensions

created_at_date:
  sql: ${created_at[date]}
  label: Created at Date
  timeframes: []

created_at_month:
  sql: ${created_at[month]}
  label: Created at Month
  timeframes: []

In this example, note that the group_label is "Created At" not "created_at", as the group label must match the label, not the field:

Custom timeframe in existing group

created_at_minute_5:
  sql: id+1
  group_label: Created At

Nested groups

Grouping types of customer data

YAML
Field browser result

views:
  customers:
    dimensions:
      first_name:
        group_label: Contact Info > Name
      last_name:
        group_label: Contact Info > Name
      email:
        group_label: Contact Info
      phone:
        group_label: Contact Info
      street:
        group_label: Location > Address
      city:
        group_label: Location > Address
      state:
        group_label: Location > Address
      country:
        group_label: Location

▾ Contact Info
  ▾ Name
      first_name
      last_name
    email
    phone
▾ Location
  ▾ Address
      street
      city
      state
    country

Grouping date fields by category

YAML
Field browser result

views:
  orders:
    dimensions:
      created_at:
        group_label: Key Dates
      shipped_at:
        group_label: Key Dates
      internal_timestamp:
        group_label: System > Timestamps

▾ Key Dates
  ▾ Created At
      Created At Date
      Created At Week
      ...
  ▾ Shipped At
      Shipped At Date
      Shipped At Week
      ...
▾ System
  ▾ Timestamps
    ▾ Internal Timestamp
        Internal Timestamp Date
        ...

Getting started

Manage content

Analyze & build

Visualize & present

Deliver content

Model data

Manage integrations

Limitations

Syntax

Properties

Date dimensions

Examples

Nested groups

​Limitations

​Syntax

​Properties

​Date dimensions

​Examples

​Nested groups

Limitations

Syntax

Properties

Date dimensions

Examples

Nested groups