- Introduction
- Installing and updating
- Navigating Postman
- Sending your first request
- Managing your account
- Syncing your work
- Discovering templates
- Creating your first collection
- Creating a workspace
- Setting up your Postman app
- Importing and exporting data
- Troubleshooting app issues
- Building requests
- Authorizing requests
- Receiving responses
- Grouping requests in collections
- Using variables
- Managing environments
- Visualizing responses
- Specifying examples
- Using cookies
- Working with certificates
- Generating client code
- Troubleshooting requests
- Using the Collection Runner
- Scheduling runs with monitors
- Building request workflows
- Importing data files
- Working with your team
- Defining roles
- Requesting access
- Sharing your work
- Your Private API Network
- Commenting on collections
- Versioning APIs
- Using version control
- Using the API Builder
- Managing and sharing APIs
- Validating APIs
- Monitoring your APIs
- Setting up a monitor
- Viewing monitor results
- Monitoring APIs and websites
- Set up integrations to receive alerts
- Running Postman monitors using static IPs
- Troubleshooting monitors
- Monitoring FAQs
- Analyzing with reports
- Documenting your API
- Authoring your docs
- Publishing your docs
- Viewing documentation
- Using custom domains
- Publishing templates
- Publishing to the API Network
- Submission guidelines
- Managing your team
- Purchasing Postman
- Billing
- Configuring team settings
- Utilizing audit logs
- Onboarding checklist
- Migrating data between teams
- Intro to SSO
- Configuring SSO for a team
- Logging in to an SSO team
- Microsoft AD FS
- Custom SAML in Azure AD
- Custom SAML in Duo
- Custom SAML in GSuite
- Custom SAML in Okta
- Custom SAML in Onelogin
- Custom SAML in Ping Identity
- Migrating to the current version of Postman
Commenting on collections
You can leave comments on collections and requests to collaborate with your teammates. You can tag your collaborators in comments to let them know that you have questions or feedback.
Contents
- Commenting on a collection
- Commenting on a request
- Reading comments
- Editing comments
- Resolving comments
- Deleting comments
- Tagging members in comments
- Next steps
The Postman app only supports comments on requests and request parameters. To leave or read comments on a collection, open the Postman Dashboard in your web browser.
Commenting on a collection
You can leave comments on collections from the Postman Dashboard.
Team members must have access to the collection in question in order to post comments.
- Sign in to the Dashboard.
- At the top, select a Workspace and then click the Collections tab.
- Open the collection you want to leave your comment on and click Comments next to the name of the collection.
Commenting on a request
You can comment on requests from the Postman Dashboard or in the Postman app. When you comment on a request, it's reflected in both the Dashboard and the app.
You can only post comments on saved requests.
Commenting from the Dashboard
- Sign in to the Dashboard.
- Navigate to the request you want to leave a comment on.
- Click Comments next to the request name.
- Write your comment, then click Add Comment.
Commenting in the app
You can add comments at the request level, on request parameters, and within the request configuration (request body, pre-request script, and test script).
Adding a comment on a request
- Navigate to the request you want to leave a comment on.
- Switch to Comment mode at the top-right of the window.
- Write your comment, then click Add Comment.
Adding a comment on request parameters
You can leave comments on request parameters (query parameters, path parameters, headers, request bodies of type form-data, and x-www-form-urlencoded).
You can only add comments on saved requests.
- Open the request you'd like to comment on.
- Switch to Comment mode at the top-right of the window.
- Click on the key, value, or description.
- Enter your comment, then click Add Comment
Adding an inline comment
You can add a comment on a specific part of a raw body, a pre-request script, or a test script.
- Open the request you'd like to comment on.
- Switch to Comment mode at the top-right of the window.
- Open the tab where you want to leave a comment.
- Highlight the text you want to comment on.
- Enter your comment, then click Add Comment
Reading comments
You can see comments made by teammates on requests and request parameters in the Postman app or the Dashboard. You can only access comments on collections from the Dashboard.
Reading comments in the Postman app
You can read comments made on the request and on request parameters from the app.
- In the Postman app, open the request that has the comments you want to review.
-
Switch to Comment mode at the top-right of the window.
- You can filter inline comments by Open Comments, Resolved Comments, or both.
Reading comments on the Dashboard
You can read all comments through the Postman Dashboard.
- Sign in to the Dashboard.
- At the top, select a Workspace and then click the Collections tab.
- Open the collection with the comments you want to read.
-
Next to the request with the comments you want to see, click Comments.
- Any comments posted on the collection as a whole will be next to the collection name.
Editing comments
You can make changes to comments you've already posted. Other team members cannot edit your comments.
- In the Postman app or Dashboard, open the collection with the comment you want to edit.
- Find the comment and click Comment > Edit.

Resolving comments
You can resolve comments made on request parameters when you no longer want them to display.
- Open the collection with the comment(s) you want to resolve.
- Switch to Comment mode at the top-right of the window.
- Click Resolve next to the comment(s) you'd like to resolve.
Deleting comments
- In the Postman app or Dashboard, open the collection with the comment you want to delete.
- Find the comment and click Comments > Delete.

For moderation purposes, admins can delete comments made by anyone, but cannot modify comments.
Tagging members in comments
When you leave feedback or a question for a specific teammate, you can let them know by tagging them in your comment.
- In the Postman app or Dashboard, open the collection or request you want to leave your comment on.
- Click Comments and write your message.
- To tag your teammate, type "@" and choose their name from the list.
- Click Add comment.
Your teammate will be notified in the app or with an email that they've been tagged in a comment. In-app notifications appear as a red dot above the bell icon at the top right.
If your teammate has disabled notifications then they will not be notified. If they don't have access to the collection they've been tagged on, they'll need to request access before they can read the comment.

Next steps
Postman comments support Markdown. For more information on formatting using Markdown refer to Markdown in API Documentation.