> For the complete documentation index, see [llms.txt](https://docs.thryve.health/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thryve.health/thryve-product-overview/visualize-beta.md).

# Visualize (Beta)

The Thryve Visualization Widget renders health data statistics and insights directly within your application based on pre-defined visualization templates. Request the visualisation specific to your user via a simple API call and embed the returned widget URL into your application.

{% columns %}
{% column width="50%" %}

<figure><img src="/files/sqFUGwIMRU8xmZJS8wIf" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}

<figure><img src="/files/2bfmy6gzlwhMqhE5gdeT" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### Supported locales

Text displayed on the widget is available in multiple languages. Currently, the following ISO-639 locales are supported:

`ar`, `bg`, `cs`, `da`, `de`, `el`, `en`, `es`, `et`, `fi`, `fr`, `hu`, `id`, `it`, `ja`, `ko`, `lt`, `lv`, `nl`, `pl`, `pt`, `ro`, `ru`, `sk`, `sl`, `sv`, `tr`, `uk`

## Visualization Widget Templates

{% hint style="info" %}
Visualization widgets are in **beta**, and we're planning to add more templates over time. If you have any specific requests for new templates or feedback on existing templates, please reach out to our product team via the support center.
{% endhint %}

### Daily Totals Template

Visualizes a single daily aggregate data type over a configurable timeframe in a single template. The template supports data types showing a daily sum, like Steps, Calories Burned, Distances, and Durations. Note that the underlying data can come from multiple sources.

{% columns %}
{% column %}

<figure><img src="/files/kiDL48RBPG2Owh1ayMd1" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

<figure><img src="/files/33Xv5X9Ofb268BMXfrQf" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

#### Supported data types

| ID     | Metric            |
| ------ | ----------------- |
| `1000` | Steps             |
| `1001` | Covered Distance  |
| `1010` | Burned Calories   |
| `1100` | Activity Duration |
| `1113` | Rest Duration     |
| `1114` | Active Duration   |
| `1115` | Walk Duration     |
| `1715` | Walk Distance     |
| `2000` | Sleep Duration    |

#### Optional Parameters

<table><thead><tr><th width="226.45831298828125">Config field</th><th>Description</th></tr></thead><tbody><tr><td><code>timeframe</code></td><td>Number of days to display. Defaults to <code>30</code>.</td></tr><tr><td><code>dataTypeId</code></td><td>The daily data type to plot. Defaults to <code>dataTypeId=1000</code> (Steps).</td></tr><tr><td><code>referenceDate</code></td><td>The visualization timeframe is calculated backwards from this day. Expects <code>YYYY-MM-DD</code> format. Defaults to today (the user's local date).</td></tr></tbody></table>

### Social Jet Lag Template

Visualizes the misalignment of your users' internal body clock on workdays and free days (e.g. weekends) by comparing the sleep midpoints and durations of those two groups. Data types SleepStartTime (2100) and SleepEndTime (2101) are used as inputs by the widget for this visualization.

<figure><img src="/files/aXhy60h2uArfwmZ3RPDx" alt="" width="349"><figcaption><p>Social Jetlag Template</p></figcaption></figure>

{% hint style="info" %}
The template requires sleep data for a minimum of 10 workdays and 4 holidays to calculate and visualize the Social Jet Lag. If the data threshold is not met, the widget will indicate to the user that more data is required.
{% endhint %}

#### Optional Parameters

| Optional Config field | Description                                                                                                                                                          |
| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `timeframe`           | <p>Number of days to visualize. Defaults to <code>28</code>.<br>For example, if <code>timeframe = 60</code>, data across { Today - 60 days } will be visualized.</p> |
| `workdays`            | Defaults to `["monday", "tuesday", "wednesday", "thursday", "friday"]`.                                                                                              |
| `holidays`            | Defaults to `["saturday", "sunday"]`.                                                                                                                                |

{% hint style="info" %}
The widget auto-sizes its content vertically. If embedded in a scrollable container, listen for the height messages the widget posts to the parent window and resize the iframe accordingly.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.thryve.health/thryve-product-overview/visualize-beta.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.