skip_parent_label

This parameter controls how child dimension labels display within a group of dimensions, such as fields created from denesting JSON.

Syntax

<dimension_name>:
  skip_parent_label: <always | never | explicit_child_label>

Properties

dimension_name

object

The name of the parent dimension. Dimension names must:

Be unique within the view
Start with a letter
Contain only alphanumeric characters and underscores

Hide dimension_name properties

skip_parent_label

string

Controls whether child dimensions prepend their label with the parent field label. Options:

always - Parent label is never prepended to child dimensions
never - Parent label is always prepended to child dimensions (default when unset)
explicit_child_label - Child dimensions with an explicit label set will not have the parent label prepended, but those without explicit labels will

Examples

Consider this example of a nested JSON field:

order_info:
  sql: "PARSE_JSON(CONCAT('{\"status\":\"', ${ecomm__order_items.status} ::
    STRING, '\", \"email\":\"', ${ecomm__users.email}, '\", \"state\":\"',
    ${ecomm__users.state}, '\"}'))"

If you were to denest the parent order_info field, it would create three child fields: status, email, and state. The following examples will use this field to demonstrate how the skip_parent_label parameter would work.

Always skip parent label

All child dimensions without parent label prefix

order_info:
  skip_parent_label: always

With this setting, child dimensions appear as:

status (not Order info Status)
email (not Order info Email)
date (not Order info State)

Never skip parent label

All child dimensions with parent label prefix

order_info:
  skip_parent_label: never

With this setting, all child dimensions include the parent label:

Order Info Status
Order Info Email
Order Info State