# Annotating Documents Vault includes robust annotation capabilities, allowing you to add or reply to annotations in your browser. There are six different types of annotations: Image, Text, Sticky Note, Line, Link, and Anchor annotations. Each annotation has two parts, the selection on the document, and the note, which includes any comments you made, if supported by type. Limited annotation functions are available for video files. See Annotating Videos for details. ### Using Comments & Annotations {#using-comments-annotations} This video demonstrates how to create various types of annotations and comments, including line annotations: Details ## Annotate Mode {#Annotate_Mode} Vault loads the Doc Info page in _Annotate_ mode if annotations already exist on the document. To enter _View_ mode, click the **Hide annotations** icon in the viewer panel. To return to _Annotate_ mode, click **View annotations**. ## Annotation Tools {#AnnotationTools} You can select different annotation tools to navigate within a document or to create annotations. The _Select_ cursor allows you to select content and then select the type of annotation to create from the context menu. Options in this menu will vary based on the type of content you select and your permissions. The _Select_ cursor is available in both _Annotate_ and _View_ mode and is enabled by default when you first access _Annotate_ mode. From _Annotate_ mode, you can also choose tools to create specific types of annotations: Comment annotations, Line annotations, Document link annotations, Permalink Link annotations, and Anchor annotations. While in _Comment_, _Line_, or _Anchor_ annotation mode, clicking on the document creates an annotation of that type. If more than one anchor exists on the document, you can also choose _Merge Anchors_ from the annotation tools menu. ## User Preferences {#UserPreferences} Vault remembers your selected annotation tool and re-selects it for you when you navigate to another document, log out and log in, or switch browsers. For example, if you select the **Document Link** tool and then navigate to a new document, _Annotate_ mode opens with _Document Link_ enabled by default. In addition, if you select content in _View_ mode without performing a Context Menu action, and then switch to _Annotate_ mode, Vault unselects the content and defaults the annotation tool to the user preference. If you lose access to an annotation tool due to a change in permissions, _Annotate_ mode defaults to the _Select_ cursor mode. Using Link to Content from the Linked Documents section of Doc Info does not update your user preference for annotation tool selection. However, if you select an annotation tool in the **Select Anchors: Select or create new anchor in this document** window, Vault will use that selection as your saved user preference. ## How to Add Image, Text & Sticky Comment Annotations {#addAnnotations} Text selections can be up to 500 words and image selections must be within the boundaries of a single page. Sticky comment annotations cannot be created over text. To add image, text, or sticky comment annotations: 1. From the Doc Info page, use the **Select** cursor to choose the text or area on the document to place the annotation. You can also use the **Comment** tool by selecting it from the **Select tool** menu while in _Annotate_ mode. 2. If the area contains selectable text, highlight the text. Vault supports whole word selection only. If the area does not contain selectable text, click and drag to select an area for an image annotation. Single click (CTRL + click on a Mac) in an area without selectable text to create a sticky comment annotation. 3. If using the _Select_ cursor, select **Create Comment** from the context menu. 4. Optional: Change the color, shape, or style of your text or image annotation by selecting from the drop-down menus in the annotation info card. 5. Type a comment in the annotation info card. 6. Optional: If you want to notify a user about an annotation, add a [user mention][3] by typing "@" and the beginning of their first name, last name, or Vault username in the _Comment_ field and selecting from the list of users. 7. Optional: If your Vault has tags, select them from the drop-down in the annotation info card to apply them to the annotation. Admin users can configure tags . 8. Click **Save**. Vault cancels annotations when you click outside of an unsaved annotation and no input exists. If unsaved user input exists, you must either confirm to dismiss or cancel to continue editing the annotation. ## How to Add Line Annotations To draw a line on the document (line annotation): 1. Open the Doc Info page and click **View annotations** in the viewer panel. If the document already has annotations, it will open in _Annotate_ mode by default. 2. Click the **Select tool** icon, then select the **Line** cursor mode. 3. Click and drag on the document to create a line. 4. Optional: Click and drag again to create additional lines in the line group. You can also resize and move individual lines or the entire line group. 5. Optional: Modify the color and width of the line using the options that appear in the annotation info card. 6. Optional: Type a comment in the annotation info card. 7. Optional: If your Vault has tags, select them from the drop-down in the annotation info card to apply them to the annotation. 8. Optional: If you want to notify a user about an annotation, add a [user mention][3] by typing "@" or "+" and the beginning of the first name, last name, or Vault user name and selecting from the list of users. 9. Click **Save**. Once saved, you can move the annotation to resize, and move individual lines or the line group. Line annotations do not appear correctly when a page is rotated in the document viewer . Make sure you are viewing the page in its original orientation when adding line annotations. ## How to Add Link Annotations Link annotations are made up of two components: links and anchors. Links and anchors are reviewed in Using Document Links & Anchors . ## Notifications Vault notifies you when users: * Add a reply to your note annotation * Add a new note or reply to an existing note on a Favorite document * Mention you in an annotation Vault only sends notifications for new user mentions. Vault does not send notifications if a user edits a note with an existing user mention. Vault limits the number of notifications from a single annotation event, preventing redundant notifications. For example, if you respond to another user's note annotation and mention them, that user will only receive one notification and one email. An Admin can configure the notification and email text . ### User Mentions {#user_mentions} When creating or replying to an annotation, you can [mention another Vault user][7] in your annotation to send them a notification about your annotation. While Vault allows you to mention one or more users, you cannot mention groups. You can only save an annotation if all mentioned users have _View Content_ and _View Document_ permissions. User mentions do not grant any permissions. After you save an annotation with a user mention, Vault sends a notification and an email to the mentioned user. If you mention a user more than once in a single comment, that user will only receive one notification and one email. An Admin can configure the notification and email text . ## Annotation Color Selector You can select a color from the palette in the annotation info card. Vault stores and uses that color for your notes, replies, and text highlighting until you select a different color. If your document role has a required color, your Admins have defined a color for you and you cannot edit this. ## Text Annotation Styles {#text_annotation_style} Annotation styles change the way the selected text displays on the page. To change between styles, select one of the following from the drop-down in the annotation info card: * **Highlight** displays the selected text highlighted. * **Insert** underlines the selected text. * **Strikethrough** strikes out the selected text. * **Revise Text** shows a dashed underline and highlight on the selected text and automatically inserts the selected text into the _Comment_ field unless other text exists in that location. * **External Link** highlights the selected text and makes it an active hyperlink to the URL you enter. ## Actions for Existing Annotations {#annotation_actions} Once you or another user has added an annotation, there are various actions available: * _Edit_ allows you to change any part of your annotation. This option is only available to the user who created the annotation. You can edit your reply on another user's annotation if your reply is the latest. Click the **Actions** menu to use this action. * _Delete_ allows you to [delete an annotation or reply][1] when the appropriate permissions or settings are configured. * _Move_ allows you to [move your annotation][10]. Click the **Actions** menu to use this action. * _Hide_ hides the annotation temporarily. This action works differently from the show/hide options in the **Filter** menu. To show an annotation that you've hidden this way, you must reload the document viewer. Other users will continue to see the annotation. Click the **Actions** menu to use this action. * _Resolve annotation_ () adds a _Resolved_ attribute to the annotation. By default, resolved annotations remain visible. You can hide them using the _Filters_ menu. You cannot resolve Link and Anchor annotations. * _Reopen annotation_ () removes the _Resolved_ status for an annotation. ### Moving Annotations {#how-to-move} Annotations are attached to a specific location on a document. To move an annotation, select **Move** from the annotation's **Actions** menu. Move the annotation to a new location and click **Save** () to save your changes, or **Cancel** () to cancel the move. Annotation Actions menu You can move annotations in the following ways: * **Comment or Link Annotations with Text Selections**: Moving the annotation changes which text is selected. Editing can also change a text selection into an image selection. * **Comment or Link Annotations with Image Selections**: Moving the annotation can move or resize the selected area. Editing can also change an image selection into a text selection. * **Comment or Link Annotations on Videos**: Moving the annotation adjusts the time signature and the selected area. * **Sticky Comment Annotations**: Moving the annotation moves the sticky note icon. Although you can't create a sticky comment over text, you can move it over a text area. You cannot resize the sticky comment icon. * **Line Annotations**: Moving the annotation can move the line group to a different location on the document. When moving a line group, you can also add, remove, or edit the lines in the group. * **Anchor Annotations**: If you have the _Manage Anchors_ permission, or you authored the annotation, you can move any anchor annotations that do not have inbound references. ## Viewing Annotations When in _Annotate_ mode, annotations appear to the right of the document in the document viewer. The annotation toolbar appears above the annotations, to the right of the document viewer toolbar. You can access the _Filters_ () menu, see the number of hidden annotations, and navigate between annotations from this toolbar. ### How to Hide Annotations If you need to add an annotation to an area where there are already multiple annotations, there is a shortcut key to help you hide all of the annotations quickly. Pressing the shortcut a second time makes the hidden annotations visible again. * On Mac: Use **Cmd** + **,** (**Cmd** + **comma**) * On Windows: Use **Ctrl** + **,** (**Ctrl** + **comma**) You can also hide all annotations or specific types of annotations from the **Filters** menu. ### Filters Menu {#filters_menu} You can use the _Filters_ menu () to show and hide annotations based on various criteria: Keyword : Enter a keyword or phrase (up to 100 characters) to show only annotations where the text selection, comment, or reply contains matching text. Created Date : Show annotations according to the date they were created. The _In the range_ filter allows you to filter on annotations created between two dates. The _Before_ filter allows you to filter on annotations created before a specified date. The _After_ filter allows you to filter on annotations created after a specified date. Replies are included when calculating the _Created Date_, meaning an older note with a newer reply can be filtered by either date. For example, a note created on January 5 with a reply on January 10 is displayed when filtering for notes before January 10 as well as after January 5. Notes : Show only unresolved or only resolved annotations. Placement : Show annotations that have a text or image selection in the document, or show page-level annotations without a text or image selection. Links : Show link annotations by type - _Document_, _Permalink_, or anchor. Filtering permalink annotations is only visible in Vaults with linking to permalinks enabled. Author : Show annotations created by yourself, or show annotations created by other users. Tags : Show only annotations with specific tags. Version : Show only annotations created in the viewed document version. This filter excludes annotations that were brought forward from previous document versions. Filter Anchors : Show only anchors that are used by specific selected documents. This option opens a dialog where you can search for and select documents. Vault will hide all anchors not used by one of the selected documents. To view all referencing documents, expand the anchors inside each link annotation on the document before clicking **Filter Anchors**. To filter out anchors that have no inbound links, uncheck **Display empty anchors**. This option is not available for videos. Vault remembers and re-applies most _Filters_ menu settings for each user, across all documents, browsers, and sessions within a single Vault. The only _Filters_ menu settings not saved are _Hide/Show Annotations_, _Filter Anchors_, _Author_, and _Tag_. When you view a document in annotate mode, Vault displays the number of annotations you've hidden with either the shortcut key or filters. Click **Reset All** to remove filters and show all annotations. ## Deleting Annotations {#deleting-annotations} The ability to delete annotations depends on your [permissions][4] and your Vault's configuration for users in the _Document Owner_ role. To delete an individual annotation or reply, select **Delete** from its **Actions** menu. ### Deleting Annotations with the _Annotate_ Permission {#delete-with-annotate-permission} Users with the required permissions can delete annotations that they authored, including anchor annotations with no inbound references. Once deleted, annotations are not recoverable. Users cannot delete an annotation on a document under _Legal Hold_ or anchor annotations with inbound references. Users with the required permissions can also perform the following deletion actions: * Delete any individual brought-forward annotation, except anchors with inbound references. * Bulk remove annotations that they brought forward. * Bulk remove annotations brought forward by any user. * Delete any anchor annotations with no inbound references. If replies exist, the original creator can delete the original annotation, which also deletes any replies. Users can delete replies to annotations if their reply is the latest available. ### Deleting Annotations as the _Document Owner_ Depending on your Vault's configuration , the user in the _Document Owner_ role on a document can delete individual annotations and replies created by any user. The _Document Owner_ must have the [required permissions][4] to delete annotations and the annotations must meet the deletion criteria listed in the [Deleting Annotations with the _Annotate_ Permission][5] section. ## Bringing Forward Annotations If your configuration allows this, you can bring forward link, note, anchor, and line annotations from previous document versions, dramatically reducing the effort required to maintain annotations throughout a document's lifecycle. ## Downloading Documents with Annotations {#download} There are two options in Vault to download and view a document's annotations offline. The first, the **PDF with Annotations** download option, is available on all Vaults. This option gives you a read-only version of the annotations. The second, **Export Annotations**, requires that your Vault uses the offline annotations feature. To download the PDF viewable rendition showing annotations in the margins, navigate to the the Doc Info page or Library, then click and select **PDF with Annotations**. You can also select this option from the **All Actions** () menu. If some annotations are hidden by [filters](#filters_menu), Vault displays the **Apply Filters** dialog. Select the checkbox to exclude filtered-out annotations from the PDF. Annotations hidden manually are not excluded. Vault includes the annotation notes in the margin of the downloaded PDF.
## Downloading Notes as a CSV File {#download-csv} You can download a CSV file of notes for any document version that has a viewable rendition and at least one annotation. To download notes, navigate to the Doc Info page, open the **All Actions** menu, and select **Download Notes**. If some annotations are hidden by [filters](#filters_menu), select **Apply Filters** in the dialog to exclude filtered-out annotations. Annotations hidden manually are not excluded. The CSV file downloads automatically. ## Character & Placemark Limits {#character-limits} The following character and placemark limits apply when creating, editing, and importing annotations via the Vault UI and Vault API: | Annotation Type | Field | Limit | | --- | --- | --- | | Anchor | Name | 140 characters | | Note, Link, Anchor | Subject | 32,000 characters | | Note, Link, Anchor | Placemark on Text Selection | 32,000 characters. Cannot exceed 500 words. Must be within a single page. | | Note, Link, Line, Reply | Comment | 32,000 characters | | External Link | URL Length | 32,000 characters | | Line | Placemark | 50 lines | Vault automatically truncates any characters beyond these limits and will not allow you to place a 51st line in a line annotation. ## Annotation Color Mapping in Action UI Every annotation in Vault retains a record of the color value assigned at the time of creation or last update, whether a legacy color or a new color associated with Action UI. For annotations with legacy color values: Vault maps the legacy color to a near-equivalent Action UI color, and displays the annotation using the new color. ## Limitations The following limitations apply to document annotations: * Vault does not allow you to add, remove, or edit annotations on archived documents , but you can still view any existing annotations on archived documents. * Vault does not support annotations on unclassified documents . ## Related Permissions {#permissions} The following permissions control your ability to annotate documents: | Type | Permission Label | Controls | | --- | --- | --- | | Document Role | Annotate | Ability to create, move, reply to, resolve, reopen, edit, or delete annotations. This option is only available to the user who created the annotation. Ability to bring forward non-resolved Note and Line annotations created by any user. | | Document Role | View Content | Ability to access the **Download Notes** action. | | Security Profile | Application: Viewer Administration: Manage Anchors | Ability to bring forward anchor annotations, or move or delete empty anchor annotations. | | Security Profile | Application: Document: Download Rendition | Ability to download documents with annotations. | See the following articles for additional annotation permissions that may be required: * Annotating Videos * Bringing Forward Annotations * Link Annotations * Offline Annotations [1]: #deleting-annotations [2]: #filters_menu [3]: #user_mentions [4]: #permissions [5]: #delete-with-annotate-permission [7]: #add_a_mention [10]: #how-to-move [11]: #character-limits