Custom JS

Write a small JavaScript snippet that fetches from any API and returns a value. The script runs on a schedule and its return value is displayed live on your dashboard.

What it is for

Use Custom JS when no built-in widget type covers your data source. Pull from a REST API, scrape a JSON endpoint, compute a derived metric, or chain multiple fetches. Any value you can express in async JavaScript becomes a live widget.

How to add it

1. Click + Add widget and select Custom JS.
2. Write your script in the code editor. The script must return (or resolve to) the value you want to display.
3. Save. The script runs immediately and shows the result.

Script format

const res = await fetch('https://api.example.com/value')
const data = await res.json()
return { result: data.price }

Configuration

Tips

• The script runs in a sandboxed Node.js environment with fetch available.
• Keep scripts under a few seconds; they time out at 10s.
• Return a plain string or number for text display, or an array of objects for table/chart display.

Display options

Text, line chart, bars, or event feed (if returning an array of timestamped entries).

Credit cost

0.02 credits per check