group_label (for Explores)

This page refers to the group_label parameter that is part of an Explore.

group_label can also be used as part of a field, as described on the group_label (for fields) parameter documentation page.

Usage

explore: explore_name {
  group_label: "Label to Use as a Heading in the Explore Menu"
}
Hierarchy
group_label
Default Value
With no group_label defined, Explores are grouped by model, with each word capitalized and underscores replaced by spaces

Accepts
A string

Definition

Use group_label to change the default organization of the Explore menu. The group_label parameter specifies the label to use as a heading in the Explore menu for this Explore.

Instead of each Explore being listed under its model's name, you can list an Explore under a new group label or under another model's name. Adding the same group_label to multiple Explores will list all of those Explores under the same heading in the Explore menu. You can use group_label to group Explores together even if they are defined in different projects.

If you use the name of another model as the value for an Explore's group_label parameter, then the Explore will be listed with any Explores that are part of that model. If you specify a value for the group_label parameter that does not correspond to a model name, Looker adds that new label as a heading in the Explore menu.

Example

Create a group heading in the Explore menu called Online Store Queries and list the Customers Explore under that heading in the Explore menu:

explore: customers {
  group_label: "Online Store Queries"
}

By adding the group label to two different Explores, you can group them together under the Online Store Queries label. In the following sample LookML, the group_label parameter is used with the order_items Explore and the inventory Explore:

explore: order_items {
  label: "Order Items"
  description: "Based on the individual items that compose customer orders"
  group_label: "Online Store Queries"
  ...
}

explore: inventory {
  group_label: "Online Store Queries"
  ...
}

The Order Items and Inventory Explores will then be listed under the Online Store Queries label in the Explore menu.

Things to know

group_label has no effect other than changing the Explore menu appearance

When you change the group_label of an Explore, this only affects the Explore's heading in the Explore menu. To change the display name of the Explore itself, use the label parameter.

The way that fields should be referenced in the LookML goes unchanged. The way that fields appear within the Explore UI is also unchanged.