> For the complete documentation index, see [llms.txt](https://docs.myshell.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.myshell.ai/ko/create/pro-config-mode/api-reference/widgets/36-data-visualizer.md).

# Data Visualizer

## Try it in the Widget Center

Click this [url](https://app.myshell.ai/robot-workshop/widget/1782389648132747264) to try this widget and copy the Pro Config template.

## Usage

This widget allows two types of input, including a table file url (.xlsx, .csv, .tsv) or a JSON string (can be obtained by JSON.stringify). You can specify how your visualization looks like in the instruction (pure natural language) and the visualized results will be automatically generated.

**Input Parameters**

<table><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default</th><th data-type="checkbox">Required</th></tr></thead><tbody><tr><td>instruction</td><td><code>string</code></td><td>The instruction to perform the plot</td><td>plot the most important relationship of this table</td><td>true</td></tr><tr><td>table_file_url</td><td><code>string</code></td><td>The url of input table</td><td><a href="https://www.stats.govt.nz/assets/Uploads/Gross-domestic-product/Gross-domestic-product-December-2023-quarter/Download-data/gross-domestic-product-december-2023-quarter-visualisation.csv">default_url</a></td><td>false</td></tr><tr><td>table_json_string</td><td><code>string</code></td><td>Provide your input json.</td><td>[{"name": "Harry", "age": 18}, {"name": "Ginny", "age": 17}]</td><td>false</td></tr><tr><td>input_format</td><td><code>string</code></td><td>the input format</td><td>csv</td><td>true</td></tr></tbody></table>

**Output Parameters**

| Name     | Type     | Description                  | File Type |
| -------- | -------- | ---------------------------- | --------- |
| viz\_url | `string` | The url of the visualization | image     |

**Output Example**

{% tabs %}
{% tab title="success" %}
{% code fullWidth="false" %}

```json
{
  "viz_url": "https://object-storage-16oh.lepton.ai/ws-k8d7q1rw/data_visualizer/output/be26d068bd264f74a09bb348a95bca55/tmpx3hfsr7j.png"
}
```

{% endcode %}
{% endtab %}
{% endtabs %}