Skip to main content
Pages are your team’s documents. You write them together, comment on them, and share them with the right people.

Create a page

  1. Open Docs in the sidebar.
  2. Hover over a space and press + (Add to this space).
  3. Choose New page. If New page is the only thing you can create there, + creates the page right away.
In an empty space, New page is shown right under the space.

Write in a page

An empty line shows Type ’/’ for commands. Type / to open the block menu, then type to filter it. The menu is split into sections: Basic blocks, Media, Databases, Advanced blocks, Inline and Embeds. Blocks you’ll use most:
  • Text: Text, Heading 1, Heading 2, Heading 3, Heading 4
  • Lists: Bulleted list, Numbered list, To-do list, Toggle list
  • Others: Quote, Callout, Code, Divider, Table, Block equation
  • Files and links: Image, Video, File, Web bookmark, Embed
  • Pages and data: Page, Link to page, Mention a person, Table view
The / menu also has the same actions as a block’s menu, such as duplicating, moving or deleting the current block.

Markdown shortcuts

At the start of a line, type one of these and a space: Type ``` for a code block and --- for a divider.

Mentions

Type @ to mention something. The list is grouped into People, Link to page, Sessions and Date. Add new sub-page at the end of the list creates a new page inside this page and links to it. Once you’ve typed a word after @, it shows under New page as New “…” sub-page. It’s there for people who can edit the page.

Images and files

Choose Image or File in the / menu. You can also paste files or drag them onto the page.

Tables

Choose Table in the / menu. The + buttons on the right and bottom edges of a table add a column or a row. Click the bar on a row or column to open its menu: Insert above, Insert below, Duplicate, Clear contents and Delete. Table view adds a database inside the page. See Databases.

Sub-pages

A sub-page is a page inside another page. Create one in either way:
  • Type / and choose Page.
  • Type @ and choose Add new sub-page.
The new page shows up as a link in the parent page.

Page icon and cover

Above the title, people who can edit see Add icon and Add cover.
  • Click the icon to change or remove it.
  • Add cover adds a color cover. On the cover, Change cover lets you pick from Gallery, Upload or Link. Reposition moves the image, and Remove takes the cover off.

Comments

  • On the whole page: press Add comment above the title (shown until the page has its first page comment), or choose Comment in the page’s menu in a database.
  • On some text: select it and press Comment in the toolbar that appears. People who can only comment can do this too.
When a page has comments, the comments icon (Comments) at the top of the page opens them in a side panel. A dot on it means there’s something you haven’t read. When a discussion is done, press Resolve on it. Reopen brings it back. In the panel, Filter shows Open or Resolved comments.

Page options

The ⋯ button (Page options) at the top right of a page has:
  • Start session
  • Copy link, Copy page content, Duplicate, Move to, Archive, Move to trash
  • Small text, Full width, Lock page
  • Undo, Export as PDF, Version history
  • Get notified, Open in
You see only the items your access allows. The menu also lets you pick the page’s font. Lock page stops accidental edits. It stays locked until someone unlocks it. Export as PDF saves the page as a PDF that looks as it does in the app. You can follow the progress in downloads. In the sidebar, each page’s ⋯ menu has Add to favorites, Copy link, Duplicate, Rename, Move to, Archive and Move to trash, and it can open the page with Open in new tab, Open in new window or Open in side peek.

Version history

Version history lists earlier versions of the page. Pick one and press Restore. The current state is kept as a version, so you can undo it. Properties are not restored.

Share a page

Press Share at the top of the page. If you have Full access, the panel has two tabs: Share and Publish. Others see only who has access. With Full access, in Share:
  • Add people by name or email. Someone outside the team joins as a guest and only sees what you share.
  • Under General access, choose who can open the page: Only people invited or Everyone at …. Anyone on the web with the link takes you to Publish.
  • Set each person’s access level.
A sub-page follows the access of the page above it until you change it; while it follows, the panel shows Inherited from …. After you change it, Restore settings makes it follow again. At the bottom of the panel, Copy link copies the page’s link and Send to channel… posts it in a channel.

Publish to the web

People with Full access can publish a page. Anyone with the public link can view it without signing in.
  1. Press Share and open the Publish tab.
  2. Press Publish.
  3. Use Copy link to copy the link, or View on web to open it.
Unpublish takes the page off the web right away. If you publish it again, it gets a new link. If you see Public publishing is turned off for this team, a team owner has turned off Allow publishing to the web in Settings › Team › Public pages.

Trash and restore

Move to trash moves a page to the trash. If it has sub-pages, they go with it, and you’re asked to confirm first. The Moved to Trash message that follows has Restore to undo it right away. To get a page back:
  1. Click Trash at the bottom of the sidebar.
  2. Find the page in the Trash tab.
  3. Press Restore. Delete from Trash deletes it for good.
Items in Trash are deleted forever after 30 days.

Ask Bottari to edit a page

Team members who can edit see Edit this page with Bottari at the bottom right of an unlocked page. Tell Bottari what to change. Its edits show as blue lines that you can revert, and only you see that chat. See Bottari and Claude Code. Bottari manual 13 pages (#940)