Sharing queries
A link that opens your SQL in someone else's Querylab.io, in a new tab, ready to run with their credentials. The SQL is encrypted before it leaves your browser and the key travels only in the link.
Creating a link
Any of these opens the dialog for the active tab:
- The editor’s ⋯ menu → Share
- Right-click the tab in the Workspace list → Share Query (Share Notebook on a notebook tab)
- Right-click inside the editor → Share Query
- In a notebook, the toolbar ⋮ menu → Share Notebook
Pick a Link expiration — 1 hour, 1 day, 7 days (default), 30 days or Never — and click Create Share Link. The link looks like
https://app.querylab.io/s/8c9f799d-…-2561c9eb9a27#k=qX3v…
Everything after # is the decryption key. Browsers never send the fragment to a server, so Querylab.io stores only ciphertext it can’t read. Cut the fragment off and the link is useless; the flip side is that anyone who has the whole link, and is signed in, can open it.
- You’re signed in — Playground can’t create links, and the desktop app needs a Querylab.io sign-in, not just local Google credentials
- The tab has SQL (or the notebook has at least one cell)
What’s in the link
| Query | Notebook | |
|---|---|---|
| Encrypted | The SQL text | All cells: SQL, text, chart configs, cell names, byte limits |
| Stored in clear | Tab name, expiry | Tab name, expiry |
| Not included | Results, billing project, per-tab limits, cursor | Results, billing projects, destination tables |
Encryption is AES-GCM with a 256-bit key generated per link.
Who can open it
The recipient must be signed in to Querylab.io. If your account belongs to an organization, the dialog adds Organization members only. and the link refuses anyone outside it — that’s automatic, not a choice. There is no way to make a link public.
What the recipient sees
The query opens in a new tab named after your tab (or Shared Query / Shared Notebook if it had no name), with a Shared query opened toast. It runs on their billing project, under their permissions, against whatever tables they can see. Nothing links back to you — if they edit it, your link still serves the original.
An expired or revoked link shows Could not open shared query - invalid or expired link.
Managing your links
⌘K → Manage shared queries opens a Shared Queries tab listing the links you’ve created, with their expiry. Revoke deletes the ciphertext on the server; the link stops working immediately and can’t be restored.