Skip to main content

Sharing a Dashboard

A dashboard can be shared outside your workspace through a secure link, so stakeholders can view the report without a Kvery account or any SQL knowledge.

Turning sharing on​

Enable sharing for a dashboard to generate a unique, hard-to-guess share link. Anyone with the link can open a read-only view of the dashboard; turn sharing off again at any time to immediately revoke access.

Two controls let you lock the link down:

  • Password — require a password before the shared dashboard will load, so the link alone isn't enough to view it. Wrong passwords are counted per address and per link: once there are too many, every attempt from that address for that link is refused, even with the right password, until a while has passed since the last wrong attempt.
  • Expiry date — set a date after which the link stops working automatically. Useful for time-boxed access.

The password and the expiry protect every tile as well, not only the page: a tile only loads while the link is valid and the viewer has entered the current password. After you change the password, everyone has to enter the new one. Queries a tile opens — through a link field or the add button — run under the dashboard's link, with the same protection.

Combine both for sensitive dashboards: a password to gate access and an expiry so it doesn't stay open forever.

What recipients see​

Viewers get a clean, read-only render of the tiles and their results. They can't edit the dashboard, see your SQL, or reach the rest of your workspace. While a tile's query has an unpublished draft, viewers of the shared link see the published version; an editor of the query who is signed in can view the draft by adding ?draft to the link.

Tips​

  • Only the data the tiles return is exposed — design tile queries to reveal exactly what you intend, using ::hidden for internal columns.
  • The share link stays the same while the dashboard exists. To lock out previous viewers, change the password or turn sharing off.
  • For programmatic access to a single query's data, prefer the public API over a shared dashboard.