Project pages

A page is a document that belongs to a project: a spec, a runbook, a decision write-up. Pages sit in the project's Pages tab, next to the work they describe.

Creating a page needs the Pro plan. Reading, editing and restoring one does not.

Pages and the Wiki are different surfaces

Both use the same editor, and it is easy to assume they are the same feature. They are not.

Project pagesWiki
WhereInside one projectWorkspace-wide
Organised byA page tree in the projectCollections, each with its own tree
Who can read itProject membersWhoever the collection grants access to

Use a project page for something that belongs to one project and is read by the people in it. Use the Wiki for something the whole company needs, with its own access rules. The Wiki has its own access model.

The Pages tab can be switched off per project, in Settings, then Features. It is on by default.

Writing one

A new page is called Untitled until you name it, and can start from a template.

Pages nest: a page can have a parent, so a project's documentation is a tree rather than a flat list. You can duplicate a page, move it, lock it, and archive it.

The editor is the same block editor as the Wiki: headings, lists, tables, task lists, code, images, callouts, diagrams, embedded boards, task embeds, mentions and a slash menu.

Versions

A version is kept as you edit, with a new one saved when the last one is more than five minutes old. So a long editing session leaves a handful of versions rather than hundreds, and you can still get back to where you were an hour ago.

You can name a version, which is the important part: a named version is kept forever, while unnamed ones are trimmed on a schedule. Before a risky rewrite, name the version you are leaving behind.

How long unnamed versions survive depends on the plan: 30 days on Free and Starter, 90 days on Pro, and kept on Enterprise.

Restoring is a single action from the version list.

Sharing a page publicly

A page can be given a public link that works without signing in. Open the share control and turn the public link on; anyone with the link can read the page, and nothing else.

Two things to be clear about:

  • The link cannot be rotated. Turning sharing off kills the link, and turning it back on gives you the same URL again. If a link has leaked, turning it off and on does not produce a new one.
  • There is no password and no expiry. It is on or off.

Treat a public link as genuinely public. Anyone who has the URL can read the page without signing in, and nothing stops the link being passed on or indexed. Do not put something behind one that you would mind a stranger reading.

Sharing a page needs edit access to it, inside a project where sharing is allowed.

When one page links to another, the page being linked to records it. So a spec that is referenced from four runbooks shows you those four, and you find out what depends on a document before you rewrite it.

Backlinks are recomputed when a page is saved, and you only ever see backlinks from pages you are allowed to read.

Who can do what

ActionNeeds
Read a pageProject membership
Create a pageProject membership, and the Pro plan
Change who can access itBeing its owner
Lock or unlock itBeing its owner
Archive itIts owner, or a project admin
Delete itIt has to be archived first

A page is visible to the project by default. Its owner can make it private instead.

Deleting takes two steps on purpose: archive, then delete. A document is the kind of thing somebody asks for again six months later.

Troubleshooting

What you seeWhat it means
"Pages require the Pro plan or higher."Creating a page needs Pro. Existing pages stay readable.
No Pages tabIt is switched off for this project, in Settings, then Features.
"Only the page owner can change access"Access is the owner's decision, not an admin's.
"Locked pages cannot be updated"The page is locked. Its owner can unlock it.
"Page must be archived before deletion"Archive it first.
"Page not found or sharing disabled"The public link is off, or the URL is wrong.
An old version has goneUnnamed versions are trimmed on a schedule that depends on your plan. Name the ones that matter.
The public link is the same as beforeLinks are not rotated. Off and on returns the same URL.