> ## Documentation Index
> Fetch the complete documentation index at: https://docs.saphion.co.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Documents

> Write, edit and share a Document with colleagues and Beacon: tabs, comments, version history and export to Word or PDF.

A Document is something you write in Saphion: a brief, a method statement, meeting notes, a report. Several people can edit it at once, comment on any passage, and ask Beacon to write or change it. It lives in Saphion, in **Creations** or in a Project, and you can export it to Word, PDF or Markdown.

> [!NOTE]
>
> Everyone with a Platform seat can make a Document. What you can do in one depends on your access to it.

## Make a Document

> [tab] Start a blank Document
>
> Choose **Creations** in the sidebar, then **New**, then **Document**. A blank Document opens at once, called "Untitled Document". Inside a Project, use the **New** choice on the Project's **Creations** tab, and the Document is filed there.
>
> Click the title to name it. A blank Document says "Start typing, or ask Beacon to…". Select **ask Beacon** to open the ask box.

> [tab] Ask Beacon to write one
>
> In a chat, ask for a document: "Write a one-page brief on the Alder Wharf programme for the client." Beacon opens a Document beside the chat, outlines it first, then fills one section at a time while you watch. See [Ask Beacon to write or change a Document](#ask-beacon-to-write-or-change-a-document).
>
> If you want a Word or PDF file instead of a Document in Saphion, say so. See [Word documents and PDFs](https://docs.saphion.co.uk/beacon/word-and-pdf.md).

## Write in a Document

Click anywhere and type. Your changes save as you go: the top of the page says **Saving…** while it happens and **Not saved** if it fails, and offers **Try saving again**. Other people editing at the same time appear as carets with their names, and **Recent active viewers** at the top shows who has the Document open.

### The toolbar

If you can edit the Document, a toolbar sits above the text. From the left:

| Control | What it does |
| - | - |
| **Tab** | Opens the Document's tabs and outline. See [Use tabs](#use-tabs). |
| **Font** | Chooses **Serif** or **Sans** for **Headings** and for **Text**. |
| **Make page wide** / **Make page narrow** | Switches the page width. |
| **Table**, **Image**, **Checklist** | Add that block at the caret. |
| **Insert** (**+**) | Opens the full list of blocks. |

Your font, width and tab choices are your own view. They are kept in this browser for that Document, apply to every tab of it and are not shared with anyone.

### Add a block

Press <kbd>/</kbd> on an empty line, or choose **Insert**, to open the list of blocks. Keep typing to narrow it.

| Group | Blocks |
| - | - |
| **Beacon** | **Ask Beacon here** |
| **Basic** | **Text**, **Heading 1**, **Heading 2**, **Heading 3**, **Quote**, **Code block**, **Divider**, **Date**, **Diagram**, **Prompt**, **Agent instructions** |
| **Lists** | **Bulleted list**, **Numbered list**, **Checklist** |
| **Media** | **Image** (upload or generate), **File** |
| **Data and links** | **Chart** (a live chart from your data), **Widgets**, **App** (one of your Apps, live), **Document link**, and mentions of **People**, **Files**, **Documents** and **Chats** |

You can also start a line with `#`, `##`, `###`, `-`, `1.`, `[]`, `>` or three backticks to make a heading, list, checklist, quote or code block as you type.

A **Prompt** is a request readers can run with Beacon about the Document. **Agent instructions** is guidance Beacon reads whenever it works on that Document. To move a block, press <kbd>Alt</kbd>+<kbd>Shift</kbd>+<kbd>Up</kbd> or <kbd>Down</kbd>. Blocks such as tables, images and charts also have a grip beside them to drag.

### Make a checklist item an Action

Hover a checklist item that is not yet linked to anything and choose **Make this an Action** at its right. The New action sheet opens already filled 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, so ticking the item finishes the Action. You need to be able to edit the Document. See [Actions](https://docs.saphion.co.uk/work/actions.md).

### Format selected text

Select some words to bring up a bar above them: **Ask Beacon**, **Comment**, **React**, the style menu (**Aa**: Text, Heading 1 to 3), bold, italic, underline, strikethrough, inline code, highlight (with a choice of colour), a list menu and **Link** (<kbd>Ctrl</kbd>+<kbd>K</kbd>, or <kbd>⌘</kbd><kbd>K</kbd> on a Mac).

## Use tabs

A Document can have several tabs, such as a main report and an appendix. Choose **Tab 1** (the number is the open tab) on the toolbar to open the list.

* Select a tab to open it. Choose the arrow beside a tab to see its headings, and select a heading to jump to it.
* Type in **New tab…** and press <kbd>Enter</kbd> to add one.
* Choose **Options** beside a tab for **Rename**, **Duplicate**, **Add subtab**, **Copy link**, **Move** (up, down, make top-level or make a subtab of another tab) and **Delete tab**.

The first tab is the Document itself: it cannot be deleted or given subtabs. Deleting any other tab moves it to the Bin, where a person who can manage the Document can restore it. See [Bin and restore](https://docs.saphion.co.uk/admin/bin-and-restore.md).

## Comment and react

Select words and choose **Comment**, or press <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>M</kbd> (<kbd>⌘</kbd><kbd>⌥</kbd><kbd>M</kbd> on a Mac). Write the comment and send it. It anchors to those words.

Comments open in a **Comments** sidebar beside the text. The sidebar shows how many threads are open and filters them: **Open**, **Resolved** or **All**. Resolve a thread when it is dealt with, and **Reopen** it if it comes back. A thread whose words have since been edited is marked **Text changed**. Press <kbd>Alt</kbd>+<kbd>Shift</kbd>+<kbd>C</kbd> (<kbd>⌘</kbd><kbd>⌥</kbd><kbd>⇧</kbd><kbd>C</kbd> on a Mac) to hide or show all comments, or use **Hide comments** in the sidebar's menu.

> [!TIP]
>
> If you can edit the Document, tick **Send to Beacon**, or write `@Beacon`, in a comment and Beacon makes the change you asked for and answers in the same thread.

## Ask Beacon to write or change a Document

Beacon writes in the Document as you watch. It outlines first, then fills one section at a time. Beacon's caret is visible in the text while it works.

* **Ask Beacon here** in the block list asks about the place where your caret is.
* **Ask Beacon** on selected text opens a card titled **Ask Beacon to edit**, with "Tell Beacon what to change" and one-tap edits: **Make it shorter**, **Make it simpler** and **Fix spelling and grammar**. The suggestions change with what you selected, for example **Say this more simply** for text, **Do these add up?** for a table or **Write a caption** for an image.
* **Ask Beacon** in the side chat works on the Document you have open.

Beacon keeps your work. If you edit a passage while it is writing, your edit wins and Beacon reads again before it carries on. It changes another person's words only when you selected them or they carry your comment. When it finishes, a message says "Beacon changed" the Document, and **Version history** shows exactly what changed.

## See and restore earlier versions

Open the title menu and choose **Version history**. It lists versions 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 a version to see it in place of the Document. **Show changes** marks what changed. **Restore this version** makes it the newest version. **Back to the document** leaves without changing anything.

Version history is offered to people who can edit the Document.

## Share and export

* **Share** opens the Share dialog, where you add people and choose what each can do. A new Document is private to you until you share it. See [Sharing and access](https://docs.saphion.co.uk/work/sharing-and-access.md).
* **Export**, the second tab of the Share dialog, downloads the Document as **Word**, **PDF** or **Markdown**. Pending changes are saved first, so the file is what you see.
* **Copy as Markdown** in the title menu copies the Document's text as Markdown without making a file.
* **Copy link** copies an address that opens only for people who can already open the Document.
* **Pin**, in the title menu, adds the Document to your favourites. See [Favourites and Creations](https://docs.saphion.co.uk/work/favourites-and-creations.md).
* **Files & sources**, in **More document options**, lists the files the Document names and the exports already made from it.

## Rename, archive and delete

The title menu has **Rename**, **Archive** and **Delete**. Archive keeps the Document, out of your lists, until you restore it. **Delete** moves it to the Bin for your plan's Bin days. See [Bin and restore](https://docs.saphion.co.uk/admin/bin-and-restore.md).

## How it works

* **Saving is automatic.** If Saphion cannot save, the page says **Not saved** and offers **Try saving again**.
* **Your edit wins.** If you and Beacon change the same passage, yours is kept.
* **Access.** A Document filed in a Project follows the Project's people. One in your Creations follows who you share it with.

## Ask Beacon

"Draft a method statement for the Alder Wharf roof works. Start with an outline and wait for my comments." Beacon outlines first, then fills each section.

"Answer the comment on the second table." Beacon reads the comment thread, makes the change and replies there.

## FAQ

> [accordion] Who can see my Document?
>
> A Document you make on your own is **Private** until you share it. One made in a Project or a Workspace belongs to that place, and everyone in it can open it, unless you or a Manager of the place lock it, which makes it **Private** again. A request to Beacon never gives anyone access.

> [accordion] Can I edit a Document at the same time as a colleague?
>
> Yes. You each see the other's caret. Edits are merged as you type, and **Recent active viewers** shows who is there. It does not lock the Document.

> [accordion] Why can I not edit?
>
> You may have view access only. Ask the person who manages the Document to change what you can do.

> [accordion] What is the difference between a Document and a Word file?
>
> A Document is written and edited in Saphion with others. A Word file is a file you download or send. Export a Document to Word when you need one. See [Word documents and PDFs](https://docs.saphion.co.uk/beacon/word-and-pdf.md).

> [accordion] Can I get back text I deleted?
>
> Yes, if it was in an earlier version. Open **Version history**, find a version from before the change and restore it.

## Related

* [Word documents and PDFs](https://docs.saphion.co.uk/beacon/word-and-pdf.md): Ask Beacon for a file to download or send.
* [Chat with Beacon](https://docs.saphion.co.uk/beacon/chat.md): Ask Beacon to write and edit.
* [Sharing and access](https://docs.saphion.co.uk/work/sharing-and-access.md): Who can open and change what you make.
* [Dashboards](https://docs.saphion.co.uk/work/dashboards.md): Live widgets you can also add to a Document.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.