Skip to main content
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. To start a new document, use New document at the top of the Documents tree in the sidebar, or the + beside a folder. See Folders and organization.

The title

The title sits at the top of the page as plain text, with the name of its folder above it if it is in one. An empty title shows Untitled as placeholder text. As you type, the last part of the breadcrumb above the document changes to match. A title can’t be empty, can’t run past 500 characters, and can’t contain /, #, |, [, ], or a line break. If you type one of those characters, the change is refused and a message tells you why:
Title may not contain any of / # | [ ] or line breaks.
The title also sets the document’s address. Renaming a document moves it to a new URL, and links to it from other documents are rewritten in the same step. See Titles and addresses.

The body

The body is a rich text editor. An empty document shows Start writing….

Adding blocks

Type / at the start of a line, or after a space, to open the block menu. It offers headings at three levels, bullet, numbered and task lists, a table, a code block, a quote, and a divider. Keep typing to narrow the list, move with the arrow keys, and press Enter to insert. Escape closes the menu. Markdown-style shortcuts also work as you type. Start a line with #, ##, or ### and a space for a heading, - and a space for a bullet, 1. and a space for a numbered list, [ ] and a space for a task, > and a space for a quote, or ``` for a code block. Point at a block and a grip appears beside it. Drag the grip to move the block somewhere else in the document. In a table, Tab moves to the next cell, and Tab in the last cell adds a row. There is no control for adding columns.

Formatting text

Select some text and a small toolbar appears above it: Bold, Italic, Strikethrough, Inline code, Highlight, and Link. The toolbar does not appear inside a code block. Link turns the toolbar into an address field. Type or paste the address and press Enter. Escape backs out without changing anything. To take a link off, clear the address and press Enter, or use Remove link. Web addresses you type or paste become links on their own. Clicking a web link inside the editor does not open it. The editor has no underline and no way to add an image.

Linking to other documents

To link to another document, type its name inside double square brackets: [[Pricing Page Spec]]. A moment after you finish typing, the link becomes clickable. Click it to open that document. A link to a document that doesn’t exist yet stays dimmed until one with that name is created. See links between documents.

Autosave

There is no save button. About half a second after you stop typing, Tatara writes your changes. Opening another page in Tatara writes anything still waiting, so clicking through to another document never loses a keystroke. The save state is in the status line at the bottom left of the window. On a phone it is in the bar along the top. When Tatara refuses a change, the line reads Failed and a message gives the reason. The usual ones are a title with a character it can’t contain, and a body over the 5 MB limit. If the connection drops, Tatara tries the save again a few times before it gives up.

When an agent writes

An agent can change a document while you have it open. For a few seconds after it saves, the top bar reads Writing, and an outline around the section that changed shows the agent and the time. Your page updates to show the new text. If you are typing when the agent’s change arrives, your page keeps your text, and your save then replaces the agent’s version. The status line shows every agent write across the workspace. See the status line.

The details rail

The rail on the right holds everything about the document apart from its title and body. To open or close it, use the button at the top right of the page (Open the rail or Collapse the rail), or press ⌘I (Ctrl+I on Windows). The shortcut works when your cursor is not in a text field. In the document text, ⌘I makes text italic instead. On a wide screen the rail opens by default and remembers whether you closed it. In a narrower window it starts closed on every document, and opening it lasts until you leave. On a phone it opens as a sheet titled Details, from the button at the right of the top bar.

Owner, type, and description

Click a value to edit it. Owner opens a list showing your name (or your email) and Unassigned.
The owner list only ever offers you. You cannot assign a document to a teammate from the web app, even though your account may have several people in it.
Type is free text for what kind of document this is, with signal, brand, … as placeholder text. The line under it, with no label, is the description: one sentence on what the document is, with One sentence on what this doc is… as placeholder text. For both, Enter or clicking away keeps what you typed, and Escape puts back what was there. Clearing a value removes it. Created and Updated are relative times and can’t be edited.

Tags

Click the tags field (it reads Add tag while the document has none) to pick from your workspace’s tags or add a new one. A document holds at most five. See Tagging a document. Links lists the documents this one points at. Linked mentions lists the documents that point back at it. Each card shows a count and the first five, with Show N more for the rest. Click a row to open that document. A link to a document that doesn’t exist yet sits at the bottom of Links with a broken-link icon and can’t be clicked. It connects on its own once a matching document is created. Each card is hidden while it has nothing to list.

Custom

Custom holds the extra properties this document carries beyond the standard ones: a review date, a customer name, whatever your workspace has defined. See extra properties. Each defined property this document has shows its value. Click one to edit it: a date opens a date picker, a choice opens its list (None clears it), and a checkbox ticks in place. Add field lists the defined properties this document doesn’t have yet. Properties that came in on a document but were never defined sit behind N unregistered keys, read-only. The card is hidden when there is nothing to show. See Filling in fields.

Locking a document

A document can be locked when its content is approved and should not drift: a brand guide, an ideal customer profile, a privacy policy. While a document is locked, nobody can change it, whether you, a teammate, or an agent, until it is unlocked. The lock is the padlock in the top bar, next to the favourites star. Click it to lock and click it again to unlock. Two kinds of people can turn it: A locked document shows Locked. Unlock it to edit. above the body, and everything becomes read-only: the title, the body, and the rail. To make a change, unlock it, edit, and lock it again. There is no way to edit a locked document without unlocking it. That is the point. A locked document also can’t be renamed, moved, or deleted, and the folders above it can’t be renamed, moved, or deleted while it sits inside them.
Agents are refused the same way. An agent that tries to change a locked document gets a rejection naming the document and who can unlock it, and is told not to write a modified copy elsewhere instead. The lock can only be released here, in the web app.

Document width

The top bar has three width buttons: Prose, Wide, and Full. Point at one to see its name. Once one has focus, the arrow keys move between them. Your choice is remembered in this browser.

Favourites

The star in the top bar adds the document to your Favourites in the sidebar, and clicking it again takes it off. See Favourites.

Other kinds of document

Not every document opens in the editor.
  • Boards, trackers, tables, maps, bases, and dashboards open in their own view. The rail starts closed, and opening it lasts until you leave. There is no width control, and the title can’t be edited on the page, so rename them from the sidebar. On a mind map you can also double-click the centre node to rename it. See Document formats.
  • HTML pages that agents build open as finished pages. See HTML documents.
  • Workbooks, slide decks, whiteboards, and data pages open on a page of their own that fills the window. See Workbooks, Slide decks, Whiteboards, and Data pages.
  • Images and PDFs an agent has stored show the file itself, with Open raw in new tab in the top bar and a File card at the top of the rail. Their titles can’t be edited on the page.