Collaboration
Work together on documents with real-time editing, comments, sharing, and version history.
Overview
Wyatt documents are built for teamwork. Multiple people can edit the same document at the same time, leave comments, and track every change through automatic version history. This page covers everything you need to know about collaborating on documents.
Real-Time Editing
When multiple people open the same document, everyone sees changes as they happen. There is no need to refresh or manually sync -- edits appear in real time for all connected editors.
Wyatt uses a conflict-free ordering system (fractional indexing) under the hood. This means two people can add new blocks at the same time without one overwriting the other. Each block has an independent position key, so concurrent edits merge cleanly.
When remote text changes arrive, Wyatt highlights only the characters that changed. The sync flash is an inline green text highlight, not a bordered pill around the whole line, so paragraph edits stay precise and easy to scan.
You will see presence indicators (colored cursors or avatars) when teammates are viewing or editing the same document.
Comments
Leave comments on specific blocks to provide feedback, ask questions, or start a discussion without editing the content directly.
To add a comment:
- Click on a block or select some text.
- Click the comment icon that appears on the right side of the block.
- Type your comment and press Enter to submit.
Comments appear as indicators next to the block they reference. Click the indicator to view or reply to the comment thread.
Comments are separate from the document content. Adding or resolving a comment does not change the document itself.
Sharing Documents
You can share a document with specific people, groups, or your entire workspace.
Visibility Settings
Every document has a visibility level:
| Visibility | Who can access |
|---|---|
| Private | Only the document owner |
| Workspace | All members of your workspace |
| Public | Anyone with the link, including people outside your workspace |
Sharing with Specific People
To share with an individual or group:
- Open the document and click the Share button.
- Enter a person's email or select a group.
- Choose their permission level: Read (view only) or Write (can edit).
- Click Share to send the invitation.
Shared users will be able to find the document in their workspace.
Permissions
Wyatt offers layered permissions so you can control exactly who can do what.
Document-Level Permissions
| Permission | What it allows |
|---|---|
| Read | View the document and its contents |
| Write | Edit blocks, add content, and make changes |
| Admin | Full control, including managing permissions |
Ownership
Documents can be owned by:
- A user -- the person who created it has full control.
- A group -- all members of the group share ownership.
- The workspace -- if no specific owner is set, workspace editors can manage it.
The owner always has full access and can override any permission restrictions.
Folder-Based Access
If a document lives inside a folder, anyone with access to that folder can access the document. This follows a familiar model: folder access grants access to its contents.
Moving a document into a shared folder may grant access to people who did not previously have it. Check folder permissions before moving sensitive documents.
Version History
Every change to every block in a document is versioned automatically. Wyatt records:
- What changed -- the content before and after the edit.
- Who made the change -- the user who edited the block.
- When it happened -- a timestamp for every version.
This history is tracked at the block level, giving you a granular view of how a document evolved over time. You do not need to do anything to enable it -- versioning runs automatically in the background.
Draft Mode and Approvals
For documents that require review before changes go live, Wyatt supports a draft-and-approval workflow:
- When approval is enabled, your edits are saved to a draft branch rather than the live document.
- You will see a notice: "Editing in draft mode. Submit for review when ready."
- When you are satisfied with your changes, submit them for approval.
- Reviewers can accept or reject the changes.
This is especially useful for contracts, policies, or any document where changes need sign-off before they take effect.
Tips for Effective Collaboration
- Use comments for feedback instead of editing directly, especially on documents you do not own. This keeps the original content intact while your suggestions are visible.
- Set clear permissions before sharing. Giving someone write access means they can modify the document immediately.
- Check version history if something looks wrong. You can see exactly what changed and when, making it easy to identify and understand any unexpected edits.
- Use the AI assistant to help merge contributions. Ask it to "combine the new sections added today" or "summarize the changes made this week."