Special Use Cases for Comments
Learn how to use and manage Comments in uncommon cases, like enabling and disabling comments for individual branches, using a CSP, and more.Using the project settings menu is not the only way to enable or disable comments. This section teaches you how to toggle comments on or off for branches, enable them project-wide with environment variables, and more.
Enabling comments project-wide opens a new communication channel that could disrupt your current feedback and iteration workflow. Enabling or disabling comments on specific branches allows you to take advantage of comments while controlling when this new style of collaboration is possible.
Vercel allows you to set Preview environment variables, which can be scoped to individual branches or to all branches which generate previews.
To enable comments for an individual branch, add the following to the environment variables for the desired preview branch:
VERCEL_PREVIEW_FEEDBACK_ENABLED=1
To disable comment for an individual branch, set the above environment variable's value to 0
:
VERCEL_PREVIEW_FEEDBACK_ENABLED=0
You can enable or disable comments project-wide with project environment variables. Navigate to your project's environment variables in your Vercel dashboard and add the VERCEL_PREVIEW_FEEDBACK_ENABLED variable.
Set its value to 1
if you want it enabled, or 0
if you want it disabled.
Our comments feature is designed to make iteration and development easier, so we've set it to automatically get out of your way when necessary. If your preview deployment is being tested in Google Lighthouse, or is visited by a bot or headless browser, the comments UI will not be injected into the DOM.
To opt out of comments while visiting a preview deployment, you can:
- Select the Hide Interface or Disable for Session options in the comments menu toolbar. Doing so will hide the comments interface in the active browser tab. Opening the preview deployment in a new tab will restore the comments interface
- Avoid interference with things like automated end-to-end tests by adding the
x-vercel-skip-toolbar
header to the request sent to the preview deployment URL. You can set the value to1
, but the value will not be read; sending this header at all will cause the comments toolbar to be disabled
Commenting is not currently supported on main
or master
branches. To use comments, you must open a pull request on a branch in your favorite Git provider.
If you have a Content Security Policy (CSP) configured with your preview environment, you may need to adjust the CSP to enable access to Comments.
You can make one of the following adjustments to the Content-Security-Policy
response header:
- Add the following to
script-src
(Most commonly used):
script-src https://vercel.live/ https://vercel.com 'unsafe-inline'
- Add the following to
connect-src
:
connect-src https://vercel.live/ https://vercel.com https://sockjs-mt1.pusher.com/ wss://ws-mt1.pusher.com/
- Add the following to
img-src
:
img-src https://vercel.live/ https://vercel.com https://sockjs-mt1.pusher.com/ data: blob:
- Add the following to
frame-src
:
frame-src https://vercel.live/ https://vercel.com
To use comments with preview deployments that have custom alias domains, you must opt into comments explicitly in your project settings on the dashboard.
Was this helpful?