Embed a report

A public link to a report opens the report on its own, without the app around it: just the canvas, for an intranet page or a wall display. Anyone who has the link can open it, without signing in. Links are created and revoked on Share a report; this page covers what the link opens and how to run it unattended.

What the link opens

Run the embed unattended (kiosk mode)

Add ?idle=1 to the end of the link, and a session starts by itself when the page opens: it reloads the numbers and turns the pages with no one at the keyboard.

ParameterWhat it setsValues
refreshHow often the charts on the page reload, in seconds.5 to 300, in steps of 5; default 60
dwellHow long each page stays on screen before the next one turns in, in seconds.5 to 300, in steps of 5; default 30

Open the embed on a specific page

Add ?page= to the embed link with the id of the page you want, and the report opens on that page. If the value is not one of the report's pages, the report opens on its first page.

Find the id in the report's own address in the app: open the report, turn to the page you want, and the address shows ?page= with that page's id (the first page is shown without it).

Add and arrange pages in edit mode; see Build a report.

When a link stops working

Questions, answered

How do I make the embed run by itself on a screen?

Add ?idle=1 to the link. A session starts by itself when the page opens, reloading the numbers and turning the pages with no one at the keyboard.

Can I choose how often the embed refreshes and turns pages?

Yes. refresh sets how often the charts reload and dwell sets how long each page stays on screen before the next one turns in. Both take seconds in steps of 5, from 5 to 300, and a value of 0 switches that half off.

Can I keep the screen on one page?

Yes. Set dwell=0 so the pages stop turning, and add ?page= to open on the page you want; the numbers keep reloading on the refresh cadence.

Why is the embed not full screen when it starts?

A browser only goes full screen after a click, so a session that starts by itself stays within the browser window, with its tabs and address bar still in view. Press Fill the whole screen in the control bar on the screen itself, and the session uses the whole display.

What happens when I link to a page that no longer exists?

The embed opens the report on its first page. A ?page= value that is not one of the report's pages is ignored.

Why does the embed show "This link is not available"?

The link was revoked, has expired, or never existed. All three show the same page and it never says which one applies; ask the report's owner for a new link.

Do report changes show up on a screen that is already open?

Not while the page stays open. The embed loads the report when the page opens, and a running session reloads the numbers, not the layout. Reload the page to pick up changes.

How long does an embed keep working?

Until the link expires or someone revokes it. The expiry is chosen when the link is created, on Share a report.