How to create documents and collaborate in real time

Create project docs, invite collaborators, see live cursors, and use version history.

5 min readUpdated February 2025

TL;DR

Open a projectDocs tab → New doc or + → name it and start typing. Multiple people can edit at once with live cursors. Use Version history to view or restore older versions.


Create a document

  1. Open a project from the sidebar.
  2. Click the Docs tab.
  3. Click New doc or the + button.
  4. Name the document.
  5. Start typing — changes auto-save.

Prerequisites: Access to the project. Members can create docs; Guests need edit permission.


Real-time collaboration

Documents support real-time editing like collaborative editing:

  • Live cursors — See where others are typing.
  • No refresh needed — Changes appear for everyone right away.
  • Conflict-free — Edits merge automatically.

Link documents to tasks

Associate docs with tasks so specs and notes stay with work:

  1. Open a document.
  2. Use Link or @ to link a task (or add it in the Linked Resources section).
  3. The link appears on both the doc and the task.

Rule: Documents and tasks must be in the same project.


Version history

  1. Open a document.
  2. Open Version history (clock or history icon in the toolbar).
  3. See a list of versions with author and time.
  4. Preview a version to compare.
  5. Restore to bring back that version (a new version is created first so you can undo).

Common issues

IssueWhat to try
Can't editCheck project permissions. You may have view-only access.
Doc and task in different projectsLinking requires the same project. Move one or create a doc in the right project.
Version history emptyVersions are created as you edit. New docs may have few entries.
Connection lostCheck your internet. Reconnect; your edits should sync when back online.

Next steps

Link documents to tasks, control doc permissions, or use AI in docs if available.

Was this article helpful?