A brief starts in one tool, gets commented on in email, is rewritten in a second file and ends up as a PDF that nobody can trace back. The work is in the Document, but the history is everywhere else.
In Saphion a Document is where the writing happens and stays. You write it, colleagues write in it with you, and Beacon can draft it or change it when you ask. Comments sit on the words they are about, every version is kept, and a Word, PDF or Markdown file is one choice away when someone outside needs a copy.
Start one in a few seconds
Choose Creations in the sidebar, then New, then Document. A blank Document opens at once. Click the title to name it, and start typing. A Document made inside a Project is filed in that Project.
Or ask Beacon in a chat: “Write a one-page brief for the client.” Beacon opens a Document beside the chat, outlines it first, then fills it one section at a time while you watch. If you would rather have a Word or PDF file, say so and Beacon makes that instead.
Write with other people, live
Several people can edit the same Document at once. Each person’s caret shows with their name, and the faces at the top show who has it open. Changes are merged as you type and saved as you go. The top of the page says when it is saving, and if saving fails it says Not saved and offers Try saving again.
To talk about a passage, select the words and choose Comment. The comment is fixed to those words and opens in a sidebar beside the text. Resolve a thread when it is dealt with, and reopen it if it comes back. A thread whose words have since changed is marked Text changed.
Ask Beacon to write or change it
Beacon works in the Document with you. Ask it to draft a section, tighten a paragraph, fix a table or answer a comment. Its caret is visible in the text while it works.
- In a comment, tick Send to Beacon or write
@Beacon. Beacon makes the change you asked for and answers in the same thread. You need to be able to edit the Document. - From the bar at the bottom, choose Ask Beacon and say what you want changed. The Document stays in view. Beacon answers, asks and shows on the item explains how that works.
- In the side chat, ask about the Document you have open.
Your edit wins. If you change a passage while Beacon is writing, Beacon reads the Document again and carries on from what you wrote. When it finishes, Version history shows exactly what changed.
Put in what the Document needs
Press / on an empty line, or choose Insert (the + on the toolbar), and the list of blocks opens. Keep typing to narrow it. There are headings, lists, checklists, quotes, code, dividers, dates, tables, images and files, a diagram, links to other Documents, and mentions of people, files, Documents and chats.
Two blocks are for Beacon. A Prompt is a request that readers can run with Beacon about the Document. Agent instructions is guidance Beacon reads whenever it works on that Document, such as “keep it to one page” or “write for a client who is not technical”.
A Document can also hold live figures: a chart, a number or a list of records that reads its own tables and stays up to date. That has its own post, Live charts inside your Documents. A Document can also hold a working App: type / and choose App, or ask Beacon for one in the Document. See A working App in any Creation.
A long Document can have several tabs, such as a main report and an appendix. Choose the tab button on the toolbar to add, rename, duplicate, move or link to one.
Turn a checklist item into an Action
A checklist in a Document is often a list of things someone has to do. Hover an item and choose Make this an Action. The New action sheet opens already filled in from the item: its words are the name, a person mentioned in it is the assignee and a date in it is the due date. Choose Create, and the item links to the new Action. Ticking the item then finishes the Action.
See earlier versions and put one back
Open the Document’s title menu and choose Version history. Versions are listed newest first, each with when it ended, who made it and how many changes it holds. A version Beacon made in a chat says Made in a chat. Choose one to see the Document as it was, use Show changes to mark what differs, and Restore this version to make it the newest. Nothing is lost by looking: Back to the document leaves it as it is.
Share it on purpose
A Document you make on your own is private to you until you share it. Choose Share to add people and set what each can do. A Document filed in a Project follows that Project’s people.
The second tab of the Share dialog is Export. It downloads the Document as Word, PDF or Markdown, and a Document with several tabs asks whether you want this tab or all of them. Pending changes are saved first, so the file is what you see. Copy as Markdown in the title menu copies the text without making a file, and Copy link gives an address that opens only for people who can already open the Document.
Beacon works with your access, as it always does. Asking Beacon about a Document never gives anyone access to it.
Common questions
Can I edit at the same time as a colleague?
Can I get back text I deleted?
What is the difference between a Document and a Word file?
Why can I not edit a Document?
Does Notetaker make Documents too?
Where to start
- Choose Creations, then New, then Document.
- Type, or choose Ask Beacon and describe what you need.
- Select a passage and Comment to bring a colleague in, or Share the Document with them.
- Choose Share, then Export, when it is ready to leave Saphion.
Or ask Beacon: “Let’s write a Document together. Ask me three questions first, then draft it.”
Documents came with Saphion v0.9.0 and are available to everyone with a Platform seat. Read more about Documents in the docs.


