On this Page
Docs Menu

Go to Field Parameter List


- tags: 'String1', 'String1'
A square-bracketed list of strings


The tags parameter lets you add text strings to a field. These strings are not used by the Looker model, but can be passed to other applications using:

  • Integrated services enabled on the Action panel. Some services require one or more fields containing certain types of data, such as a phone number. Use the tags parameter to identify those fields that can be used by a service.
  • API calls. For API calls, tags can be useful for providing arbitrary metadata about a field to an outside application.


Adds two text tags, “Important Data” and “Customer Data”, to the customer_count_distinct measure.

- measure: customer_count_distinct tags: [‘Important Data’, ‘Customer Data’] type: count_distinct sql: ${customer.id}

Using tags with Integrated Services

Some integrated services in the Action panel require that you identify a specific field in your LookML model using the tags parameter. This will be a field or fields that provide identifying data to that service.

For example, the Twilio Send Message service sends a message to phone numbers. It requires a query that includes a phone number field, and that you identify the phone number field in LookML using tags: ["phone"]. Looker uses the tags parameter to identify which field in the query contains phone numbers that should be sent to Twilio. Your LookML for the phone number field could look like this:

measure: phone {
  tags: ["phone"]
  type: string
  sql: ${TABLE}.phone ;;

Some integrated services can be called from a row in an Explore, dashboard tile, or Look. In this case, Looker marks the tagged field with three dots to indicate that there is a dropdown list. Click on the three dots to see the Actions available for that link:

Other integrated services can be used when sending the results immediately or scheduling a data delivery. If a query’s results contain the required tagged fields for an enabled service, then the Destination field of the scheduling or sending window displays the service. Looker also displays the service as a destination if the service does not require a tagged field.

For more information about using the integrated services, see the How to Deliver Data section of the Actions page.

The list below shows all services that are integrated with Looker and can be enabled via the Action panel. The Tags For This Action column lists any tags required by that integrated service.

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