Guides · Audience — sharing with the outside
Audience — sharing with the outside
Every outward door in one room, and who is actually looking.
How do I share one document?
Every document is private by default. Nobody can see it until you create a share link.
Ask your assistant for a share link (get_share_link) and you get a URL with a secret token in it. Anyone with that link can view the document — treat it like a key. Share links can be set to expire, and they can be revoked and reissued at any time.
A share link can also ask for a password. It does not stop somebody forwarding the link and the password together — nothing can — but that is not what it is for. It protects against the accident: the reply-all, the wrong Sarah, the screenshot in a deck. Someone who forwards the link without the password has not leaked the document. Ask for one when you get the link, tell your assistant to send it by a different route than the link itself (a different message, a different channel), and that separation is the whole protection. Passwords are stored hashed and never shown again, even to you — if one is lost, mint a fresh link with a fresh password.
If you want to look at your own document, you don't need a share link at all: sign in and open it from your site. Signing in shows you everything you have access to.
There is also a sharing review (review_sharing) that lists every live link in your workspace, so you can see at a glance what is currently reachable from outside.
What about a whole living page — for a customer?
Audience is the fourth module in the switcher: every door to the outside world, in one room, with revoke where the row is.
Pages lists every outward door — share links, embeds, portals, read-only plan links — sorted by how much each one reaches. People shows who has come through the named doors. Reach shows whether anyone is actually looking: opens are counted, but visitors are never identified.
A PORTAL is how you share a living part of your site with a customer: one space (or the whole site), read-only and always current. It can be an open link, or a named door where each visitor enters their name — named visitors can be revoked one at a time. Ask your assistant to create one (create_portal), or review and revoke from the Audience module.
There is also "See it as…": you can walk your own site exactly as a visitor or as one portal's audience sees it, so you can check what is reachable before you send the link. While you are seeing-as, nothing can be changed — it is strictly a viewing mode.
Can I see my site the way they will?
Yes — "See it as…" walks your own site exactly as a visitor, or as one portal's audience, sees it. While you are in that view nothing can be changed, so you can check what is reachable before sending anyone the link.
Can a page live inside our intranet?
You can embed a Profusia document into SharePoint, Confluence, Notion, Teams, or an intranet page.
Ask your assistant for embed code (get_embed_code). It will ask where you are putting it rather than asking for technical details, and gives you something you can paste. The embedded view shows the document plus a small strip saying what it is, how current it is, and how to get back to the full version.
Pasting a plain link into Slack, Teams or Notion also produces a proper preview automatically.
Embed access is a separate permission from a share link: forwarding a share link does not let someone embed the document. You can revoke an embed at any time (revoke_embed).