Embed monitoring widgets in your own dashboard
# Embed monitoring widgets in your own dashboard
Partner widgets are ready-made components you drop into any page you control — an internal WordPress page, a client portal, a Notion embed — to show live monitoring data from your Ravnsight account without sending anyone to ravnsight.com.
## Components
- **Dashboard** — everything in one: account KPIs, plus a per-site view of monitors, Detective findings, incidents, alerts and uptime. A switcher filters between *All sites* and a single site.
- **Overview**, **Monitors**, **Incidents**, **Alerts**, **Uptime**, **Site switcher**, and **Detective** (WordPress agent findings + pending updates) as separate components.
## Embedding — three steps
1. Under **Settings → Widgets**, create a **widget token**. Name it, and optionally lock it to one site and to the domains you will embed on.
2. Paste the loader **once per page**:
```html
```
3. Add a component wherever you want it (copy the exact snippet from the token in settings):
```html
```
Each component renders in a self-sizing iframe and refreshes on its own. They are responsive: on a narrow column or a phone they compact automatically, and the Dashboard stacks.
## Do I need an API key?
No. The widget token is the only credential — you never create or paste an API key. The token is read-only.
## Are they secure?
A token exposes only read-only monitoring data for your account (uptime, incidents, alert history, Detective findings) — never settings, billing, or the ability to change anything. The allowed-domains list stops other sites from framing your widget in a browser. Because the token lives in your page's HTML, treat it as semi-public: anyone who can view the page can read the data, so embed on pages you trust. Revoke a token any time in settings.
Widgets require the **Partner** plan.