looker-update-dashboard-element
“looker-update-dashboard-element” updates an existing element in a Looker dashboard.
2 minute read
About
The looker-update-dashboard-element tool updates an existing element (tile) in a Looker dashboard. It supports updating query-based tiles (vis, data), text/Markdown/Slate tiles (text), and extension/data app tiles (extension), including notes, subtitles, title visibility, and refresh intervals.
Compatible Sources
This tool can be used with the following database sources:
| Source Name |
|---|
| Looker Source |
Example
kind: tool
name: update_dashboard_element
type: looker-update-dashboard-element
source: looker-source
description: |
This tool updates an existing element (tile) in a Looker dashboard.
It supports updating query-based tiles (`vis`, `data`), text/Markdown/Slate tiles (`text`),
and extension/data app tiles (`extension`).
Required Parameters:
- dashboard_id: The ID of the dashboard containing the element.
- dashboard_element_id: The ID of the element to update.
- For query tiles (`type` omitted, `'vis'`, or `'data'`): `model`, `explore`, and `fields` define the data for the tile.
Optional Parameters:
- type: The type of dashboard element (`'vis'`, `'data'`, `'text'`, or `'extension'`). Note that `'extension'` is automatically inferred when `extension_id` is provided.
- extension_id: The updated extension ID (e.g. `'db::<id>'` from `create_data_app_extension` or `'app::<id>'` from LookML extensions) for `'extension'` tiles. For extension tiles, query fields (`model`, `explore`, `fields`) should be omitted as the extension manages its own queries via the Looker SDK.
- title: The new title for query-based or extension dashboard tiles.
- title_text: The header title text for `'text'` tiles.
- subtitle_text: The subtitle text displayed below the title.
- body_text: The text, Markdown, HTML, or Slate JSON body content for `'text'` tiles.
- rich_content_json: A JSON string containing properties for rich text (Slate) elements (e.g., `'{"format":"slate"}'`).
- note_text: Note text attached to the tile.
- note_display: Where the note appears on the tile (`'above'`, `'below'`, or `'hover'`).
- note_state: The display state of the note (`'expanded'` or `'collapsed'`).
- title_hidden: Whether to hide the tile title (`true`/`false`).
- refresh_interval: Auto-refresh interval for the tile (e.g., `'1 hour'`).
- pivots, filters, filter_expression, dynamic_fields, sorts, limit, tz: Query parameters that customize a query tile.
- vis_config: A JSON object defining the visualization settings.
- dashboard_filters: An array of dashboard filters to connect to this element.
Reference
| field | type | required | description |
|---|---|---|---|
| type | string | true | Must be “looker-update-dashboard-element”. |
| source | string | true | Name of the Looker source. |
| description | string | true | Description of the tool that is passed to the LLM. |
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.