label

LookML
Version

On this Page
Docs Menu

Go to Explore Parameter List

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

label can also be used as part of a model, described here

label can also be used as part of a view, described here

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

label can also be used as part of a reference line, described here

Usage

label is a child of
explore
explore: bad_view_name
...
1st
Tab
label: 'Label I Want'
a string

Definition

label changes the title of an explore in the Explore menu and in the Explore itself:

If you do not explicitly add a label to an explore definition, the label defaults to the name of the explore, but nicely formatted. Underscores are changed to spaces, and each word is capitalized.

Examples

Make the Explore menu option appear as Users instead of User:

- explore: user label: 'Users'

Make the Explore menu option appear as Product ID Info instead of Product Id Information:

- explore: product_id_information label: 'Product ID Info'

Common Challenges

label Has No Effect Other Than Changing The Explore Menu Appearance

When you change the label of an explore, only the Explore menu is affected.

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. If you prefer the LookML references and field names to change, use the from parameter instead.

Things to Know

Avoid label When Possible By Naming Views Properly

If you know that you always want a view to appear in a certain manner to your business users, consider giving that name to the view. Then you won’t need to use label.

Typically label is only used when you want to:

  • Change the way that an explore name is formatted. For example, you can make the explore name “abc_info” appear as “ABC Info” instead of “Abc Info”.
  • Create two different explores that are based on the same view.
Still have questions?
Go to Discourse - or - Email Support
Top