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 thegroup_label
(for fields) parameter documentation page.
Usage
group_label: "Label to Use as a Heading in the Explore Menu"
}
Hierarchygroup_label |
Default ValueWith nogroup_label defined, Explores are grouped by model, with each word capitalized and underscores replaced by spacesAcceptsA 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.
Consider this example of an Explore menu:
- If you use the name of another model as the Explore’s
group_label
, then the Explore will be listed with any Explores that are part of that model.
In the screenshot above, if two of the Explores are from anonline_store queries
model but the other two (Customers and User Data) are from another model, you could usegroup_label
for Customers and User Data to group them under Online Store Queries. - If you specify a
group_label
that does not correspond to a model name, Looker adds that new label as a heading in the Explore menu.
In the screenshot above, if all four Explores are from various models and there is noonline_store_queries
model, then you could specifygroup_label
for all four Explores to have them appear together under the Online Store Queries heading.
Examples
Create a group heading in the Explore menu called Online Store Queries and list the Customers Explore under that heading in the Explore menu:
By adding the group_label
to two different explores
, you can group them together under the Online Store Queries label:
The Explores are then listed together under that label in the Explore menu:
Common challenges
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.