Skip to content
Last updated on June 5, 2023
4 min read

Using Comments with Preview Deployments

This guide will help you get started with using Comments with your Vercel Preview Deployments.

You must be logged in to create a comment. You can press c to enable the comment placement cursor.

Alternatively, select the speech bubble button in the comments toolbar. You can then select a location to place your comment with your cursor.

You can use @ to mention Team members and alert them to your comment. For example, you might want to request Jennifer's input by writing "Hey @Jennifer, how do you feel about this?"

A comment using the @ symbol to mention someone.

You can add emojis by entering : (the colon symbol) into your comment input box, then entering the name of the emoji. For example, add a smile by entering :smile:. As you enter the name of the emoji you want, suggestions will be offered in a popup modal above the input box. You can select one of the suggestions with your cursor.

Emojis appearing after the : symbol is used.

Emoji reactions are available on comments. They help avoid extra comments for quick reactions

To add a reaction, select the emoji icon to the right of the name of the commenter whose comment you want to react to. You can then search for the emoji you want to react with.

A comment with reactions.

Note: Custom emojis from your Slack organization are supported when you integrate the Vercel Slack Beta app.

You can add screenshots to your comments with Vercel's Chrome extension. Access the Chrome extension in the preferences menu.

Every new comment placed on a page begins a thread. The comment author, PR owner, and anyone participating in the conversation will see the thread listed in their Inbox.

The Inbox can be opened by selecting the button in the comments menu bar. A small red badge will indicate how many new notifications there are, if any have been added since you last checked. You can navigate between threads using the up and down arrows near the top of the inbox.

To check notifications within a Preview Deployment, select the Inbox button on the comments menu bar. You can move the Inbox to the left or right side of the screen by selecting the top of the Inbox modal and dragging it.

You can filter threads by selecting the branch name at the top of the Inbox. A modal will appear, with the following filter options:

  • Filter by page: Show comments across all pages in the inbox, or only those that appear on the page you're currently viewing
  • Filter by status: Show comments in the inbox regardless of status, or either show resolved or unresolved

You can copy a link to a comment in two ways:

  • Select a comment in the Inbox. When you do, the URL will update with an anchor to the selected comment
  • Select the ellipses (three dots) icon to the right of the commenter's name, then select the Copy Link option in the menu that pops up

By default, activity within a comment thread triggers an email notification for all participants in the thread. PR owners will also receive email notifications for all newly-created comment threads. Emails are sent to the address associated with your Vercel account.

Activities that trigger an email include:

  • Someone creating a comment thread
  • Someone replying in a comment thread you have enabled notifications for or participated in
  • Someone resolving a comment thread you're receiving notifications for

Whenever there's new activity within a comment thread, you'll receive a new email, which will also be part of a single email thread.

To disable email notifications, select the options button with the ellipses (three dots) icon in the comments menu bar. Select Preferences to open the preferences modal. Choose either All, Replies & Mentions, or Never under the Notifications section.

You can also manage notifications for individual threads in the Inbox. Select the three dots (ellipses) icon to the top-right of any comment and select either Turn off notifications for replies to mute the thread, or Get notified about new replies to subscribe to the thread.

The option to turn off notifications for replies in a thread.