Why is my dashboard blank?

Almost always because that Grafana refuses to be shown in an iframe. By default Grafana sends X-Frame-Options: deny; the operator must set allow_embedding = true in grafana.ini, or you can use a public/shared dashboard link or a snapshot, which are made for sharing.

Can it log in to my Grafana?

No. The embed can't enter credentials, so the dashboard must be viewable without signing in — anonymous access, a public/shared dashboard link, or a snapshot.

Does it need an API key?

No. It embeds the dashboard the same way a browser tab would — no key, no plugin. It only needs an internet connection (or your LAN, for a homelab Grafana).

What's the default dashboard?

Wikimedia's public Grafana instance, showing real traffic to Wikipedia's CDN. It's one of the few big public Grafanas that allows embedding, and it makes a great demo until you paste your own URL.

Yes — free, no download, in your browser. Grafana itself is whatever your instance is; this saver just displays it.

A Grafana display option that hides the navigation and header so only the dashboard panels are shown.

Why does Grafana block embedding by default?

The allow_embedding setting defaults to false, so Grafana sends an X-Frame-Options: deny header. Grafana says this mitigates clickjacking, where a site is shown in a hidden frame to trick users into clicking.

What do I need for a dashboard to appear in the frame?

Grafana has to permit embedding and the dashboard must be viewable without signing in, for example through a public shared link or an instance with anonymous viewing enabled.

Grafana Dashboard Screensaver

The Grafana Dashboard screensaver embeds any Grafana dashboard, solo panel or snapshot fullscreen in kiosk mode — paste your dashboard URL in the settings and the saver adds Grafana's own kiosk, refresh and theme parameters. The default shows Wikimedia's public Grafana. It's free, needs an internet connection, and ESC exits.

How the Grafana Dashboard screensaver works

The saver iframes the Grafana URL you set, appending Grafana's own URL parameters: kiosk (hides the menus and header), refresh (auto-reloads the panels on your chosen interval) and theme.

Any URL Grafana itself can render works — a full dashboard (/d/…), a single solo panel (/d-solo/…), or a snapshot link.

Your Grafana must allow being iframed: a public/shared dashboard link, a snapshot, or an instance with allow_embedding = true (and anonymous viewing) in grafana.ini. The browser can't sign in inside the frame, so auth-walled dashboards stay blank.

The default URL is Wikimedia's public Grafana — their real CDN traffic dashboard — which permits embedding, so the preview works out of the box.

Putting a Grafana dashboard on a wall screen

Grafana is an open-source platform for visualising metrics, logs and other time-series data, used by operations and engineering teams to monitor servers and applications. A dashboard is a set of panels, each backed by a query to a data source such as Prometheus or a SQL database. Kiosk mode hides the menus and header so that a screen shows only the panels, which suits a wall display.

Embedding is a security decision, not just a display option. Grafana's allow_embedding setting, in the [security] section of its configuration, defaults to false, and while it is false Grafana sends an X-Frame-Options: deny header telling browsers not to render it inside a frame. The documented goal is to mitigate clickjacking. Administrators can enable embedding deliberately, or share a dashboard publicly so it does not require sign-in.

A frozen or blank panel usually has a cause on the Grafana side: the data source is down, the time range has no data, or the refresh interval is too long. A dashboard is only as useful as the freshness of its queries, so choose a refresh that matches how quickly the underlying data changes.

A worked example

Point it at your homelab — say https://grafana.local:3000/d/abc123/server-health with anonymous access and allow_embedding = true — and your CPU, memory and network panels become the screensaver, refreshing every minute. In Multi-view, give each cell a different /d-solo/… panel URL for a proper ops wall.

Settings & tips

Dashboard URL — paste the address straight from your browser; the saver adds the kiosk/refresh/theme parameters for you.
Kiosk mode — hides Grafana's side menu and header so only the panels show. Turn it off if you want the dashboard title bar visible.
Auto-refresh — uses Grafana's own refresh parameter, so panels re-query on the interval without reloading the page.
For a single panel instead of a whole dashboard, use Grafana's Share → Embed link (a /d-solo/… URL) — ideal for small Multi-view cells.

Frequently asked questions

Why is my dashboard blank?: Almost always because that Grafana refuses to be shown in an iframe. By default Grafana sends X-Frame-Options: deny; the operator must set allow_embedding = true in grafana.ini, or you can use a public/shared dashboard link or a snapshot, which are made for sharing.
Can it log in to my Grafana?: No. The embed can't enter credentials, so the dashboard must be viewable without signing in — anonymous access, a public/shared dashboard link, or a snapshot.
Does it need an API key?: No. It embeds the dashboard the same way a browser tab would — no key, no plugin. It only needs an internet connection (or your LAN, for a homelab Grafana).
What's the default dashboard?: Wikimedia's public Grafana instance, showing real traffic to Wikipedia's CDN. It's one of the few big public Grafanas that allows embedding, and it makes a great demo until you paste your own URL.
Is it free?: Yes — free, no download, in your browser. Grafana itself is whatever your instance is; this saver just displays it.
What is kiosk mode?: A Grafana display option that hides the navigation and header so only the dashboard panels are shown.
Why does Grafana block embedding by default?: The allow_embedding setting defaults to false, so Grafana sends an X-Frame-Options: deny header. Grafana says this mitigates clickjacking, where a site is shown in a hidden frame to trick users into clicking.
What do I need for a dashboard to appear in the frame?: Grafana has to permit embedding and the dashboard must be viewable without signing in, for example through a public shared link or an instance with anonymous viewing enabled.

← All Technology & Developer screensavers