This page refers to the
group_labelparameter that is part of an
group_labelcan also be used as part of a dimension, dimension group, measure, or filter as described here
group_label is a child of
|group_label: 'Label To Use as a Heading in the Explore Menu'|
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
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.
For the discussion below, consider the following example of an Explore menu:
- If you use the name of another model as the Explore’s
group_labelthen 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 an online_store_queries model but the other two (Customers and User Data) are from another model, you could use
group_labelfor Customers and User Data to group them under Online Store Queries.
- If you specify a
group_labelthat 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 no Online Store Queries model, then you could specify
group_labelfor all four Explores to have them appear together under the Online Store Queries heading.
Create a group heading in the Explore menu called Online Store Queries and list the Customers
explore under that heading in the Explore menu:
group_label Has No Effect Other Than Changing The Explore Menu Appearance
The way that fields should be referenced in the LookML goes unchanged. The way that fields will appear within the Explore UI is also unchanged.
Things to Know
group_label to Reorder the Explore Menu
The Explore menu is always arranged in alphabetical order, but you can use
group_label to get some Explores higher in the Explore menu. For example, since the underscore character appears before
A, you can use the
"_Favorite Explores" to create the group header _Favorite Explores that displays at the top of the Explore menu.