group_label

LookML
Version

On this Page
Docs Menu

Go to Explore Parameter List

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

group_label can also be used as part of a dimension, dimension group, measure, or filter as described here

Usage

group_label is a child of
explore
explore: explore_name
...
1st
Tab
group_label: 'Label To Use as a Heading in the Explore Menu'
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.

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_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 an online_store_queries model but the other two (Customers and User Data) are from another model, you could use group_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 no Online Store Queries model, then you could specify group_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:

- explore: customers group_label: 'Online Store Queries'

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 will appear within the Explore UI is also unchanged.

Things to Know

Use 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 group_label "_Favorite Explores" to create the group header _Favorite Explores that displays at the top of the Explore menu.

Still have questions?
Go to Discourse - or - Email Support
Top