> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tatara.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Writing and editing documents
> How the Tatara editor works: always-on editing, autosave, document width, and the properties rail.
Opening a document in Tatara is the same thing as editing it. There is no separate read mode and no Edit or Done button. You click into the text and type, and Tatara saves what you change.
## The title
The title sits at the top of the reading column as a plain text input. An empty title shows `Untitled` as placeholder text. As you type, the breadcrumb above the document updates to match.
A title cannot contain `/`, `#`, `|`, `[`, `]`, or a line break. If you use one, the save is rejected and you see:
> Title may not contain any of / # | \[ ] or line breaks.
The title also determines the document's address. Renaming a document moves it to a new URL and rewrites links to it from other documents in the same operation. See [Folders and organization](/app/organizing).
## The body
The body is a rich text editor that stores markdown. An empty document shows `Start writing…`. You can write paragraphs, headings at three levels, ordered and unordered lists, quotes, and inline emphasis.
The editor is deliberately small. It has:
* No code block support.
* No toolbar.
* No slash menu.
* No way to switch to a raw markdown view.
* No table or image insertion.
If a document already carries YAML frontmatter at the top of its body (from an agent write, for example), that block is preserved exactly as written on every save. It is never parsed into the editor and never shown to you.
## Autosave
There is no save button. Roughly half a second after you stop typing, your changes are written. Navigating away flushes anything still pending, so you do not lose a keystroke by clicking to another document.
The current state is shown in the topbar:
| Indicator | Meaning |
| ---------------- | ----------------------------------------------- |
| `Ready` | Nothing to save. |
| `Editing…` | Changes are queued and will be written shortly. |
| `Saving…` | A write is in flight. |
| `Saved` | The write succeeded. |
| `Failed to save` | The write was rejected or failed. |
`Failed to save` is the only signal you get when a write is rejected, and it does not tell you why. The most common cause is a rule the editor does not enforce locally: an invalid character in the title, or a sixth tag on a document that is capped at five.
## Document width
The topbar has a three-way width control labelled `Document width`, with options `Prose`, `Wide`, and `Full`. Click an option, or use the arrow keys to move between them once one is focused.
## The properties rail
The rail on the right holds everything about the document that is not its title or body. Toggle it with `⌘I` (`Ctrl+I` on Windows) or the topbar button, which reads `Collapse properties (⌘I)` when the rail is open and `Show properties (⌘I)` when it is not. Your choice persists.
| Card | Holds | Editable |
| --------------------- | ---------------------------------------- | -------- |
| `Properties` | `Owner`, `Type`, `Description` | Yes |
| `Tags` | The tags on this document | Yes |
| `Links` | Documents this one links to | No |
| `Linked mentions` | Documents that link to this one | No |
| `Custom` | Extra properties carried on the document | No |
| Last card, unlabelled | `Created`, `Updated` | No |
### Owner, type, and description
`Owner` is a dropdown. It shows the person's name or email, or `Unassigned` when nobody is set, and `Unassigned` is always available as an option.
The owner dropdown only ever lists you. You cannot assign a document to a teammate from the web app, even though your workspace may have several people in it.
`Type` is a free text field for what kind of document this is, with `signal, brand, …` as placeholder text. `Description` is a free text field for one sentence on what the document is. Both commit when you press Enter or click away, and revert if you press Escape. Clearing a field to empty removes the value.
### Tags
Tags are chips with a remove button each, plus an `Add tag` input. Press Enter or click away to add. Adding a tag that is already there does nothing.
The input accepts anything you type. There is no picker, no autocomplete, and no check against your tag registry.
A document can carry at most five tags, and the editor does not stop you adding a sixth. The save fails instead. See [Organizing with tags](/app/tags).
### Links and linked mentions
`Links` lists the documents this one points at. `Linked mentions` lists the documents that point back at it. Both are read-only; click a row to open that document. Links to documents that do not exist yet appear dimmed and are not clickable, and they resolve on their own once a matching document is created.
The whole card disappears when a document has neither outbound links nor mentions.
### Custom and timestamps
`Custom` lists any additional properties stored on the document beyond the standard ones, sorted alphabetically. These are read-only in the web app: an agent can write them, you cannot edit them here.
`Created` and `Updated` sit at the bottom of the rail as relative times. Both are read-only.
Documents that render as a board, tracker, table, or base view do not have the properties rail or the width control, and their titles are read-only on the document page. Rename those from the sidebar instead.