How pages are seen & shared

Whether a Knowledge page shows up for you — or for the agent in a conversation — comes down to two independent things: whether you're allowed to see it, and whether it's in scope for the room you're in. Here's how that works, and why some pages are visible everywhere while others stay with one team.

Two gates every page passes

A page is shown only when it clears both. Reach is about you; scope is about the conversation.

Reach — are you allowed to see it?

Set by where the page is filed in the org tree and who has access to that Area. Access flows down a branch, never sideways to a sibling team — unless a page is shared with a group you belong to.

Scope — is it in this conversation?

In a room, the agent looks only within the room's Area and its parents, plus the workspace-wide Common Area. Sibling Areas stay out of that room, except for pages shared with one of your groups.

Reach follows the org tree

Every Knowledge page lives in an Area — a node in your workspace's org tree (for example Finance, or Finance → Tax). Access is granted on an Area, and it flows down: give a group access to Finance and they can read every page filed under Finance and any Area beneath it. Where a page is filed is its home: it sets who reaches the page by default, and it is what picks the page's owning group when the page is created — the team that reviews changes to it. Moving a page afterwards moves the page, not its owner.

Access flows down the tree, never sideways. A grant on Finance does not reach a sibling Area like Commercial — each branch stays private to the people granted on it. The one way across is a share, made page by page from the page itself.

The org-wide read baseline

Every member gets a read baseline across the whole organization. That baseline lets you read the pages you already reach — it is permission to read, not a key to every Area. It deliberately does not open Finance, Payroll or Commercial to everyone; those stay reach-gated, so a team's pages remain the team's until access is granted on their Area.

What the agent sees in a conversation

Each conversation is anchored to one Area. Inside it, the agent's Knowledge searches are confined to that Area and its parents — the broader context the room sits within — but not to sibling Areas. A room anchored at Finance → Tax draws on Tax and Finance and the workspace-wide pages above them, and stays out of Payroll or Commercial. Reach still applies on top: the agent never surfaces a page the room's owner couldn't read themselves.

Some pages do reach into a room from outside its branch, and each of them is there because someone deliberately put it there: pages in the Common Area, pages shared with a group you belong to, and pages owned by a group you belong to. Nothing crosses a branch by accident.

Common: shared with the whole workspace

Some reference knowledge belongs to everyone — the fiscal calendar, company holidays, the default currency, shared data-source conventions. That lives in the Common Area: every member can read it, and the agent can reach it in any conversation, whatever the room is anchored to. It is the only Area that reaches everyone; a page filed anywhere else stays with its branch unless it is shared with another group.

Sharing one page with another team

Often a single page has to cross a branch — Operations needs one Finance definition, but not the rest of Finance. File the page once in the Area that owns it, then share that page with the other team's group. A share only ever opens access: it never takes anything away, it opens that one page rather than the branch around it, and it can be revoked from the same panel.

It is made from the page itself, by a member of the group that owns the page — so the team accountable for the page decides who else reads it, without an admin changing anyone's access and without a second copy to keep in step. What the other group gets is the standing any reader of that page has: they can read it and propose changes to it. Reviewing those changes stays with the owning group, so sharing a page never hands over the say on what it says.

A shared page travels with the group it was shared with. Its members can read it wherever it sits in the tree, and the agent can draw on it in their conversations too — including rooms anchored in their own Area, which the page's Area would otherwise keep it out of. When what they need is a page and everything nested under it, share the top page and include its child pages — that follows the page's own nesting, so other pages that merely sit in the same Area are not swept in.

Say why when you share. The reason is recorded next to the group on the page's Share panel, alongside who shared it and when — so months later the access reads as a decision someone made rather than something nobody can account for.

Which one to use

Work down this list — the first one that fits is the right one.

  1. File it in the Area that owns it

    The default, and right for nearly every page. Everyone with access to that branch reads it, and the team it is filed under is the team that reviews changes to it — so file it with whoever is accountable for it being correct, not with whoever happens to be reading it today.

  2. Share it with another team's group

    When one or two other teams need that page and not the rest of the branch. The page keeps one home, one owner and one version; the other team reads it and can suggest changes, while review stays with the owner. Use it for a definition another team depends on, or a handbook a neighbouring team works from.

  3. Move it to Common

    When it is reference material the whole workspace needs. If you catch yourself sharing the same page with a third group, take that as the signal: it has stopped being a hand-off between two teams and become company-wide.

What to avoid: widening a group's access to a whole Area in order to hand over one page. That gives them everything else in the branch as well, now and in future, and access is granted on an Area rather than withheld page by page.

This is all about Knowledge pages. Data connections follow their own placement rules and are not opened by a page share, so a connection two teams both need is filed by an admin on an Area that sits above them both.

A worked example

Take a workspace with Finance (holding Tax and Payroll), Commercial, and Common. Here's who sees a page depending on where it's filed.

Where the page is filed Who can read it Agent in a Tax room Agent in a Commercial room
Under Finance → Tax People with access to Tax Visible Hidden
Under Finance (the parent) People with access to Finance Visible Hidden
Under Finance, shared with the Commercial group People with access to Finance, plus the Commercial group Visible Visible
Under Commercial People with access to Commercial Hidden Visible
At the workspace top level People with workspace-wide access Visible Visible
In the Common Area Everyone in the workspace Visible Visible

"Visible" assumes the room's owner can read the page — reach always applies on top of scope. A shared page follows the reader rather than the room: it is in scope for a member of the group it was shared with, in any room they are in, and stays out of scope for everybody else.