This page refers to the
labelparameter that is part of a view .
labelcan also be used as part of a model, described on the Model parameters documentation page.
labelcan also be used as part of an Explore, described on thelabel(for Explores) parameter documentation page.
labelcan also be used as part of a field, described on thelabel(for fields) parameter documentation page.
labelcan also be used as part of a reference line, described on the Dashboard reference line parameters documentation page.
Usage
view: view_name { label : "desired label for the view" }
Definition
The label
parameter helps make Explores more user-friendly by allowing you to set the view names that appear in the field picker
. If not specified, the label defaults to the name of the view.
Example
In the field picker, make the view appear as Product ID Infofor a view named product_id_information
:
view: product_id_information {
label: "Product ID Info"
}
Things to consider
A label
does not change LookML references
The label affects only the displayed name of the view in the Explore; the label does not affect how you refer to the view in LookML. Views with labels are still referenced with the normal ${view_name.field_name}
syntax in your LookML files.
A label
can affect multiple Explores
Unlike view_label (for Explores) and view_label (for joins) , this parameter affects all Explores that use the view.
A label
isn't necessary if you name views thoughtfully
A view does not need a label
parameter if the name already appears and is formatted how you want your users to see it in the field picker. If you know how you want a view to appear to your users, you can often consider this when naming it, avoiding the need to use label
.
Typically label
is only used when you want to perform one of the following tasks:
- Change the way that a view name is formatted. For example, you can make the view name "abc_info" appear as "ABC Info" instead of "Abc Info"
- Create two different views with different dimensions and measures that are based on the same SQL table

