Skip to content →
  1. Working in Linear
  2. Documents
Sign upOpen app

Documents

Overview⁠

Use documents to plan work, record progress, and take notes. Draft privately or collaborate with teammates, and keep documents alongside the work they inform.

Create and find documents⁠

To start a private document, open Documents in the sidebar and create one from My documents. Documents others share with you appear in Shared with me.

You can also create a document alongside your work. Select + on the Overview tab of a project or initiative, or on a team’s home page. In an issue, choose Create document from the overflow menu. Once created, project and initiative documents appear on the Overview tab. Team documents appear in the Documents tab on the team’s home page.

Sharing documents⁠

A personal document starts out private. Open Share in the top-right corner to invite someone directly or move the document to a project or team.

To add people individually, select Share and enter their name. You can add workspace members, but not guests. Sharing with someone gives edit access by default, however you can change this if necessary.

To move a personal document, open Share, select Private, then search for and choose the project or team. Moving it can make it visible to people you haven’t added, including guests who have access to that project or team. When you move a document to a public team or project, edit access is granted to everyone in the workspace by default. You can change that access level if needed.

To make the document private again, open Share and move it back to My documents. This removes access for people you invited directly and anyone who had access through the project or team.

Edit documents⁠

Click in the body of a document to start editing. Type / to see formatting options. Changes save automatically, and you can see teammates’ edits as they happen.

To ask Linear to edit a document, press ⌘/Ctrl + J and describe the change, or select text and choose Add to chat. When the document and its chat are open side by side, blue lines show where Linear made changes.

Version history⁠

Every document (and project description) has version history, so you can see or revert to earlier document versions when needed. Open history through the display options menu. Agent edits and changes made by loops also create version history checkpoints. When Linear edits a document on your behalf, the change appears in version history as “Your name via Linear.”

Show author names⁠

You can show who (or what loop) wrote text in a document by searching for show author names in the ⌘ + K menu, or through document display options. If you’re not seeing the option to enable them, you may need to increase the width of your Linear window.

Document templates⁠

You can create document templates to write documents faster, and guide creators to share information effectively. These templates can be selected when creating a new document inside a project or issue.

Create document templates from workspace settings or from a team’s settings. Once you’ve created the document template, press save to make the template available for your team and workspace members.

To edit, duplicate or delete a template, go to the same page where you created the templates and then hover over the template name in order to show contextual controls. Click on the overflow menu and take the desired action.

Document subscriptions⁠

Select the bell icon in the top-right corner of a document to subscribe yourself or a teammate. When you create a document, you’re subscribed automatically. Subscribers are notified about comments, replies, and significant changes to the document.

Document comments⁠

Select text and press the comment button, or use Cmd Opt M to leave an inline comment. Subscribed or mentioned members will receive notifications about comments and replies.

Reply to comments, or resolve them by clicking the check icon.

To view resolved comments, click “Show resolved comments” in the top-right corner of the document.

Reference documents⁠

Reference documents in issue descriptions, comments, agent guidance fields and even in other documents by typing @ followed by part of the document’s name and selecting it from the results.

If you mention a document in an agent guidance field, the agent can reference the instructions in that document before performing another action.

Link to headers⁠

To copy a URL to a specific header, hover over the left side and click Copy link. Sharing this URL with a colleague in your workspace will direct them to this specific section.