---
title: "JSONata | Grafana Plugins documentation"
description: "This document explains the jsonata usage in JSON API data source"
---

[Documentation](/docs/)![breadcrumb arrow](/static/assets/img/icons/grafana-icon-breadcrumb-arrow-gray.svg) [Plugins](/docs/plugins/)![breadcrumb arrow](/static/assets/img/icons/grafana-icon-breadcrumb-arrow-gray.svg) [JSON API data source](/docs/plugins/marcusolsson-json-datasource/latest/)![breadcrumb arrow](/static/assets/img/icons/grafana-icon-breadcrumb-arrow-gray.svg) JSONata

Open source Grafana Cloud

[JSONata](https://docs.jsonata.org/) is a query and transformation language for JSON data.

If you’re new to JSONata, start by looking at some [simple queries](https://docs.jsonata.org/simple).

[Dashboard variables](/docs/grafana/latest/variables/) are available as JSONata variables, e.g. `$instanceName`. Since dashboard variables can have multiple values, the JSONata variable is always an array. If your variable contains a single value, you can use `$instanceName[0]` to index the first value in the array.
