Documents

Documents are pages you write in Deckbell. A page can live on a board, next to that board's issues, or in the workspace, for things that aren't about one board: a handbook, a roadmap, meeting notes for everyone.

• A board's pages: open the board and choose Documents (or open the board in the sidebar and choose Documents).
• The workspace's pages: choose Documents at the top of the sidebar.

Everyone in the workspace can read every page, the same as boards.

Create a page

1. Open Documents on a board or in the workspace.
2. Choose + next to the board's name, then Blank page or From a template…. An empty board or workspace shows a New page button too.
3. Type a title, press Enter, and start writing.

Pages save by themselves a moment after you stop typing, and when you leave the page. The top of the page says Saved once it's done.

To add a page inside another one, hover over the page in the list and choose +, or use … → Add a page from a template.

Organize pages

The list on the left shows the pages as a tree. Pages can sit inside other pages, as many levels deep as you like.

• Reorder: drag a page up or down.
• Put a page inside another: drag it to the right, under the page you want it in. Drag it to the left to take it out again.
• Expand or collapse a page with the arrow next to it.
• Filter: type in Filter pages to find a page by its title.
• Move to another board (or to the workspace's pages): open the page and choose … → Move to…. The pages inside it move along.

On a phone, the list is its own screen. While a page is open, tap the page icon at the top left to show the list.

Writing and formatting

The editor shows formatting as you type, and pages are stored as Markdown.

• Type / for a menu of blocks: headings, bulleted, numbered and to-do lists, quotes, callouts, code blocks, tables, dividers, images and files, issue links, issue cards and mentions. Keep typing to narrow the menu, for example /table.
• Markdown shortcuts work too: ## for a heading, - for a bullet, [] for a to-do, > for a quote, three backticks for code.
• Select text to make it bold, italic, struck through, code or a link.
• Tables: with the cursor in a table, use the buttons above it to add or remove rows and columns.
• Images and files: paste them, drag them onto the page, or choose Image or file in the / menu. Images show in the page; other files become a link.
• Callouts are coloured boxes for notes, tips and warnings.
• Icon: choose Add icon above the title to give the page an emoji. It shows in the list too.

Link and embed issues

• Type an issue's ID, like WEB-42, anywhere in a page. It's highlighted, and hovering over it shows the issue's title, status and assignee.
• Type # to search for an issue and insert a link to it.
• Choose Issue card in the / menu to show an issue as a card with its live status, title and assignee.

Each issue lists the pages that link to it, under Mentioned in documents in its details. See Issue details.

Mention people and agents

Type @ and choose a person or an agent. The person gets a notification in their inbox, by email, and on their phone. They're told once: mentioning them again on the same page doesn't notify them again.

Ask an agent

Mention an agent and write what you want after its name, for example "@Coder write the proration rules for seat changes". The agent starts working, the same as when you mention it in an issue comment or in chat:

• In a comment, it starts right away. It replies On it in the same thread, and posts its result there when it's done.
• In the page, it starts a few seconds after you stop typing, so it reads your whole request. It opens a comment thread on the page with On it, and replies there with its result. Choose Comments to see it.

The agent reads the page (its title and text), what you asked, and, for a comment, the rest of the thread. A coding agent that changes code opens a pull request and links it in its reply.

Each mention starts the agent once. Saving the page again, or mentioning the same agent again where it's already mentioned, doesn't start it again. Restoring an old version doesn't start it either. You need permission to run agents, and runs use your plan's AI credits, as they do everywhere else.

Comments

Choose Comments at the top of a page to open its comments.

• Comment on the page: write in the box at the bottom of the comments.
• Comment on some text: select it and choose Comment. The text is highlighted in the page; select the highlight to jump to its comments. If the text changes later, the comment stays, marked as being about text that changed.
• Reply: select a comment, then write in the reply box under it.
• Resolve a thread when it's done. Resolved threads are hidden; choose Show resolved to see them, and Reopen to bring one back.
• Edit or delete your own comments from their … menu.

The page's author and the people who commented on it are told about new comments. People you mention in a comment get a mention notification instead.

Editing at the same time

You see who else has the page open at the top of the page, and "Ana is editing" while someone is typing.

When someone else saves while you're editing, Deckbell doesn't overwrite either of you. When you save next, it shows Ana changed this page while you were editing:

• Keep mine saves your version on top. Theirs is still in the history.
• Take theirs loads their version and drops your changes since you opened the page.

People who are only reading see the new version as soon as it's saved.

Version history

Choose … → Version history to see earlier versions of the page. Saves by the same person within 10 minutes count as one version.

Choose a version to see what changed since then (removed lines in red, added lines in green), or turn off Show changes since this version to read it as it was. Restore this version makes it the current page. Nothing is lost: the page as it was before the restore is in the history too.

Changes made by AI tools through MCP show as "via MCP".

Templates

When you create a page you can start from a template:

• Built-in: Spec / PRD, Meeting notes, Retrospective, Runbook and Decision record.
• Your workspace's own: open any page and choose … → Save as template. Everyone in the workspace can then start pages from it. Workspace templates are part of the Pro plan and up.

Search

Press ⌘K (Ctrl K on Windows and Linux) and type: pages show under Documents, found by their title or text. To find a page in a board's list, type in Filter pages.

Lock a page

Choose … → Lock editing to stop changes, for example on a runbook. A locked page can still be read and commented on; only its author and admins can edit it or unlock it.

Delete and restore pages

Choose … → Move to trash on a page (or in the list). The pages inside it go to the trash with it. You can undo right away from the message that shows.

Trash, at the bottom of the list, shows deleted pages for 30 days. Choose Restore to bring a page back, with the pages that were inside it, or delete it for good. After 30 days pages in the trash are deleted automatically. While your workspace is on legal hold, the trash isn't emptied and pages can't be deleted for good.

Share a page on the web

Choose Share on a page, then turn on Share on the web. Anyone with the link can read the page, without signing in, but not change it or see anything else in your workspace.

• The link is long and random, so it can't be guessed.
• Let search engines find it is off by default: the page asks search engines not to list it.
• Turning Share on the web off stops the link working at once. Turning it on again makes a new link.
• Pages shared on the web show a globe next to their name in the list.

Only the page's author and admins can share a page. The workspace owner can turn public links off for the whole workspace in Settings → Security; that stops every shared link. Sharing and unsharing are recorded in the audit log.

Import pages

Choose + → Import… in the list to bring pages in, up to 200 at a time:

• Markdown: a .md file, or a .zip of them. Exports from Notion, Confluence and Obsidian work: folders become pages with their files inside them, a page's first heading becomes its title, and images in the zip are copied in.
• Notion: paste a link to a Notion page. Its sub-pages come along unless you turn that off. Connect your Notion account first; see Notion & Confluence.
• Confluence: paste a link to a Confluence page. Its child pages come along too. Connect your Atlassian account first.

Notion and Confluence pages are read with your own account, so you can only import what you can open there.

Permissions and plan limits

• Everyone in the workspace can create, edit and comment on pages.
• Deleting or restoring someone else's page, locking a page, sharing it on the web and moving it to another board take its author or an admin.
• On the Free plan a workspace can have 50 pages (pages in the trash count until they're deleted for good), and the version history shows the last 7 days. Older versions are kept, and show again after upgrading.
• Paid plans have unlimited pages and full history. Workspace templates need Pro or up. See Billing.
• On Business and Enterprise, the workspace's retention period also deletes pages, versions, comments and files nobody has touched within it, and on Enterprise legal hold keeps them all.

Documents in the mobile and desktop apps

The mobile and desktop apps list each board's documents; tapping one opens it in your browser.

Documents for AI agents and MCP

AI tools connected through MCP can list, search, read, create and edit pages, and comment on them. They edit in small steps (replace a piece of text or a section, or add to the end), and every change is kept in the page's history. Scripts can do the same through the REST API.

When a hosted agent starts on an issue, it also reads the pages that mention the issue, and pages linked from its description.