# Issue documents

Create documents for issues.

![Image of a issue document in Linear](https://webassets.linear.app/images/ornj730p/production/14e641502347fa4d3ef750586ab575f05fce3636-2760x1401.png?q=95&auto=format&dpr=2)

## Overview

Create documents inside of issues to keep relevant information and updates in one central place. Use documents to create specs and provide additional resources to issues.

## Create documents

Create documents from an issue's Resources section by clicking Add document. Documents are added to the issue's Resources section.  
  
In documents, you can type in plain text, use code snippets, format with headers and reference issues and projects. 

## Create 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.  
  
To create a document template, you can navigate to either the workspace template settings or team template 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

You can subscribe to notifications for specific documents by clicking on the bell icon in the upper right of the document and selecting yourself or another team member to notify. Document subscriptions are per-document and separate from issue subscriptions, so issue followers are not automatically subscribed to document updates.

The creator of a document will be automatically subscribed to the changes in the document.

![Subscribe members to document](https://webassets.linear.app/images/ornj730p/production/c7378992d628c0b31a809268c31dfcd0b5b66da6-734x156.png?q=95&auto=format&dpr=2)

Notification types include document changes, comments, and replies. You do not get notifications for actions you have taken on a document, but you will receive notifications for when

* A comment or reply has been made in a document.
* Material changes to the content of a document.
* A document was deleted.
* A team member subscribes or unsubscribes you to a document.
* A team member mentions you in a document
* A team member mentions you in a comment

![Notifications for document subscriptions](https://webassets.linear.app/images/ornj730p/production/a28b7d05be18d255b6ac810fe4aec6008cc3c9d3-842x576.png?q=95&auto=format&dpr=2)

## Inline comments

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

Reply to comments, or resolve them with a single click.

![Reply or resolve comments](https://webassets.linear.app/images/ornj730p/production/2082fe6a903a9ad0350a87ea5c67120ff75ec239-612x284.png?q=95&auto=format&dpr=2)

The full comment history of a document is available in the chat bubble icon in the upper right.

![Icon for show resolved comments](https://webassets.linear.app/images/ornj730p/production/1dc3fe1a2a5e52ee72262fc4930fe59f4cd41c05-480x176.png?q=95&auto=format&dpr=2)

## Collaborative editing

Edit documents by opening them and clicking anywhere in the editor to begin editing. We'll show when the document was last edited and by whom. Linear offers collaborative editing, so you'll see input cursors if another user is editing or viewing the text. All changes are instantly saved and synced to everyone in realtime. You can revert documents to a previous version in the `…` menu at the top and choosing _"Revert document content"_.

## Editor slash commands

Type `/` to see additional formatting options in documents (and issues.) Using this menu you can create formatting types including:

* Headers (H1, H2, H3)
* Lists (bulleted, numbered, checklists)
* Codeblocks
* Dividers
* Blockquotes

## Open documents

Use `O` then `D` to open the document picker, or open a document directly from an issue's Resources section.

## Reference documents

Reference documents in issue descriptions, comments, and even in other documents by typing @ while in edit mode followed by the document name. This action can also be used to reference issues or projects; matching documents will appear in the lowest section.

## Link to headers

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

![Copy heading URL button on the left side of header formatted text](https://webassets.linear.app/images/ornj730p/production/901c6d1a7644e409c7f958bf76df67135a4533bb-329x153.png?q=95&auto=format&dpr=2)

### External URLs

If you'd like to link related files that live outside of Linear, you can add a link to the Resources section of an issue or using `Ctrl+L` on your keyboard.