Once a visualization answers the right question, select Export to turn it into a reusable dashboard tile, embed, API request, or alert.
Choose an export#
| Export | Use it when |
|---|---|
| To Dashboard | Teammates should revisit the metric inside GraphJSON |
| Static iframe | The chart configuration is fixed and you want the simplest embed |
| Embed API call | Your server needs to change filters or other parameters dynamically |
| Data API call | You want GraphJSON’s aggregated result but will render it yourself |
| Alert | You want email or SMS when a single-line metric crosses a threshold |
Save to a dashboard#
Choose To Dashboard, select an existing dashboard or create one, and save the tile. Dashboards are the right default for internal reporting because the visualization remains managed in GraphJSON.
Before saving, give the chart a clear title and verify:
- the time zone and range
- the aggregation and metric
- every filter
- whether comparison is enabled
- the chosen granularity
Continue with Manage and share dashboards for layout, full-screen presentation, sharing, and retirement.
Use a static iframe#
A static iframe URL contains an encrypted visualization configuration. Put the returned URL in an iframe:
<iframe
src="https://graphjson.com/embed?p=..."
title="Weekly completed checkouts"
width="100%"
height="360"
loading="lazy"
></iframe>
The chart loads live data using the saved configuration.
Security: Anyone with an embed URL can view the chart it represents. Treat the URL as a bearer capability, avoid placing sensitive dimensions in public embeds, and replace the embed if the URL is exposed.
Generate dynamic embeds#
Use the visualization API from your server when one or more values must change per request—most commonly a user_id or account_id filter.
Do not call the visualization endpoint directly from browser code because the request contains your GraphJSON API key. Generate the iframe URL on your server, then send only that URL to the browser.
Retrieve JSON data#
Use the data API when you want to:
- render with your own charting library
- combine a GraphJSON aggregate with application data
- power a server-generated report
- inspect the exact result behind a chart
Start from Export → As Data API Call so the generated payload matches the working visualization.
For CSV boundaries, large raw exports, retention, and deletion, read Export, delete, and move your data.
Create an alert#
Alerts are available from Single Line visualizations. See Create alerts for threshold and comparison options.