Skip to content →

Project documents

Create documents for projects.

Image of a changelog document in Linear

Overview

Create documents inside of projects to keep relevant information and updates in one central place. Use documents to create specs, PRDS, and share status updates with the project team.

O then P to open documents

Cmd/Ctrl I to open project details sidebar and view documents

then start typing a document name (no spaces) to reference and link documents in the editor

E to edit

Shift P to move document to a new project

Cmd/Ctrl Shift , to copy document link

Use the same editor shortcuts as in issues

Basics

Create documents

Create documents when inside of a project by navigating to the project details sidebar and selecting the + button. You'll be required to give the document a title and can pick a custom icon and icon color. Start typing in the document like you would in issues as it uses the same Markdown editor. In documents you can type in plain text, use code snippets, format with headers and reference issues.

Create document templates

Similar to issue 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.

To create a document template, you can navigate to either the workspace template settings or team template settings. Create the document as you'd like the template to be, then press Save.

To edit 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. From there, you can edit the the template, rename it, or delete it.

Edit documents

Edit documents by opening them up and typing E or selecting the pencil button. We'll show when the document was last edited and by whom.

Open documents

While in a project view, you can open documents with the shortcut O then D or by selecting it from the project details sidebar.

Reference documents

Reference documents in issue descriptions, comments, and even in other documents by typing + while in edit mode followed by the document name (no spaces). As you type the first letter, you'll see matching document titles show up in a dropdown.

External URLs

If you'd like to link related files that live outside of Linear, you can add a link to the Resources section in the project details page instead.