User Guide Getting Started Help Center Documentation Community Training
New LookML
Old LookML
New LookML
Looker
  
English
日本語
label (for Models)

This page refers to the label parameter that is part of a model.

label can also be used as part of an Explore, as described on this documentation page.

label can also be used as part of a view, as described on this documentation page.

label can also be used as part of a field, as described on this documentation page.

label can also be used as part of a reference line, described on this documentation page.

Usage

label: "Label I Want"

Hierarchy

label

Default Value

None

Accepts

A string

Definition

label helps make Explores more user-friendly by allowing you to set the model names that appear in the Explore menu.

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

Examples

Make the Explore menu option appear as Users for a model named user:

label: "Users"

Make the Explore menu option appear as Product ID Info for a model named product_id_information:

label: "Product ID Info"

Common Challenges

label Doesn’t Change the Model Name Everywhere

Changing the label of a model affects the Explore menu and the way the model is displayed in listings of Looks and dashboards. Explore URLs, the Looker IDE, and the SQL Runner still show the actual model name. Consequently, the way the model should be referenced in LookML and Admin settings remains unchanged.

Things to Know

Avoid label When Possible By Naming Models Thoughtfully

A model does not need a label parameter if the name already appears and is formatted how you want your users to see it in the Explore menu. If you know how you want a model to appear to your users, you can often consider this when naming it, avoiding the the need to use label.

Often label is used to change the way a model name is formatted. For example, you can make the model name “abc_info” appear as “ABC Info” instead of “Abc Info”.

Top