Guides · Audience — sharing with the outside
Audience — sharing with the outside
Everything shared outside, in one place, and who is 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 require a password. It protects against accidents, such as a reply-all or a link sent to the wrong person; it does not stop someone forwarding the link and the password together. Ask for a password when you get the link, and send it separately from the link (in a different message or channel). Passwords are stored hashed and can't be shown again, even to you. If one is lost, create a new link with a new password.
To open your own documents you don't need a share link: sign in and open them from your site.
A sharing review (review_sharing) lists every live link in your workspace, so you can see what is reachable from outside.
What about a whole living page — for a customer?
Audience is the fourth module in the switcher: everything reachable from outside the workspace, in one place, each with its own Revoke.
Pages lists every outside link (share links, embeds, portals, read-only project links), sorted by how much each one reaches. People shows named portal visitors and recipients. Reach shows whether anyone is looking: opens are counted, but visitors are never identified.
You can ask to be told the first time a share link is opened: say so when your assistant makes the link ("tell me when it's opened"). The notice appears once, in Notifications, not by email. Opens are counted and never identified, so it tells you the link was used, not who used it.
A portal shares 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. On a named door an owner or admin can also let visitors comment: plain-text comments on the documents in the portal, with no account. Each one lands in that document's discussion marked as from a visitor whose name isn't verified, visitors see only their own, and it is off until you switch it on from the portal's row in Audience. Ask your assistant to create one (create_portal), or review and revoke from the Audience module.
"See it as…" lets you browse your own site as a visitor, or as one portal's audience, to check what is reachable before you send the link. Nothing can be changed in this view.
Can I see my site the way they will?
Yes. "See it as…" shows your site as a visitor, or one portal's audience, would see it. Nothing can be changed in that view, so you can check what is reachable before you send 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 asks where you are putting it and gives you code to 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).