Setting up Postman
In the header of Postman, click the gear icon and select "Settings" to open the SETTINGS modal. You can also use the keyboard shortcut (CMD/CTRL + ,) to open the modal.
Postman tries to minimize the number of settings you have to change, so some defaults are automatically set. You can customize your settings based on your use case.
- Trim keys and values in request body: If you’re using the form-data or url-encoded modes to send data to the server, switching this to "ON" will cause any parameters to be trimmed.
- SSL certificate verification (native apps only): Prevents Postman from checking validity of SSL certificates while making a request.
- Always open requests in new tab: Set this option to ON to open requests in a new tab. This option is, by default, set to OFF. Which means each time you click a request in the side bar, Postman opens the request in the preview tab.
- Always ask when closing unsaved tabs: If you set this option to OFF, Postman does not prompt you to save changes in your unsaved tabs. By default, this option is set to "ON".
- Language detection: Setting this to JSON will force a JSON rendering, irrespective of the response Content-Type header.
- Request Timeout in ms (0 for infinity): Set how long the Postman should wait for a response before saying that the server isn’t responding. A value of 0 indicates infinity - Postman will wait for a response forever.
- Max response size: Option to limit the size of response (in Megabytes) that is rendered by Postman. If the limit is exceeded, Postman will inform you that the received response is large (default limit: 50 MB) and provide options to increase the size limit or download the response. Note that rendering large responses can impact Postman's performance.
- Disable Request Validation: Switch off request validation if you do not want Postman to attempt to validate your requests.
If you want Postman to persist your file paths, then you must save your files in Postman's default working directory. When you work with files in form-data request bodies and binary file bodies, save them to this directory to let Postman persist your file's path relative to the working directory. This means your files loaded from within the working directory run smoothly across devices if other users use the same files on their devices. It also allows you to run collections that require file uploads with Newman.
Postman flags a warning for files that are not stored in this directory.
However, delimiting the working directory can have some unintended security issues as follows:
- It is against the general principle of security to give system-wide access to a program as it exposes a user's system to all types of threats.
- Restricting the working directory would prevent safety issues arising when files obtained from external/anonymous sources are used. For example, a collection that the user has obtained from the internet. The user may or may not have proper information about the collection and as such may not understand if the collection serves some other hidden function.
- Absolute file path can also be given to postman, but when sharing it may not work for the user it is shared to as absolute paths can vary between systems.
To learn more about this feature, refer to Sending body data.
- Location: Path in your local filesystem which Postman considers as the working directory. You can put any files in the location and Postman will persist the path relative to the working directory. The default path populated as a placeholder is
For the Postman desktop app, you can modify the working directory. While uploading a file to the app during a POST request, you will be able to view all the files in the working directory since the file path will be persisted in the collection. To ensure a seamless experience for your team members, it is recommended that you keep files in the
~/Postman/files directory. The only limitation is that the team members also maintain the same working directory structure.
For Postman web, the working directory cannot be modified. When you upload a file on the web, it creates a folder with a random alphanumeric name (such as
6OPkYiXVr) in the
~/Postman/files directory even when the file is selected within the working directory or outside the working directory. Since the file’s relative path to the working directory remains unchanged, the new folder created enables you to continue testing with files selected anywhere from your Desktop. You can view all the files within the newly created folders in the working directory.
- Allow reading files outside working directory: Set this option to ON if you want Postman to read files from outside the Postman working directory. Postman persists your file paths for binary file and form-data request bodies. To learn more about this feature, refer to Sending body data.
You may encounter errors for file reference:
- Mini warning ⚠️ icons will be appear when the specified file reference does not exist or the setting to read it from outside PWD is disabled.
- The Postman console will display a warning for file reading errors. It will also display errors if a collection wants to read a file outside the working directory and the setting for it is disabled.
- For Newman, it will read from the default working directory and can be modified using CLI options. File reading errors are displayed as console errors. You can utilize Newman verbose mode to find more information about these errors.
- Send no-cache header (recommended): Sending a no-cache header makes sure you get the up-to-date response from your server.
- Send Postman Token header: If an XmlHttpRequest is pending and another request is sent with the same parameters then some browsers returning the same response for both of them. Sending a random token avoids this. This can also help you distinguish between requests on the server side.
- Retain headers when clicking on links: If you click on a link in a response, Postman creates a new GET request with that URL. If you want to retain the headers that you set in the previous request set ON here. This is useful if you are accessing mainly protected resources.
- Automatically follow redirects: Prevent requests that return a 300-series response from being automatically redirected.
- Send anonymous usage data to Postman: Option to disable sending basic anonymous usage data (button clicks and app events) to Postman. Postman feeds usage data into product improvements.
- Two-pane view: Toggle between showing the response below, or beside, the request.
- Variable autocomplete: Enable this to turn on autocomplete feature for your variables.
- Font Family: Select the font family for the text that appears in Postman. You can revert the changes at any point by clicking Reset.
- Font Size: Adjust the font size in pixels for the text that appears in Postman. Note that this setting impacts only the Test Scripts, Pre-request Scripts, and Response Pretty View.
Pick your pleasure: choose a light or dark theme for Postman.
This is where you can view keyboard shortcuts available for your operating system here.
Import and export data in bulk inside Postman. This will overwrite your existing collections and environments so be a little careful. It always helps to take a backup before you are importing other files. Learn more about importing and exporting data in Postman.
Download Newman, Postman's command-line companion, to integrate Postman collections with your build system or run automated tests for your API through a cron job. Learn more about Newman.
If you are signed in to Postman, your data is synced with the server, making sure you have it all next time you use Postman (and not just locally). You can also manually perform sync using the Sync icon in the header toolbar of Postman. Learn more about syncing.
Add and view client certificates on a per domain basis. Learn more about setting certificates.
Configure your proxy settings in Postman using this tab. For more information on Proxy, see How to configure proxy in Postman.
This is where you can verify your current version of Postman. There are also some helpful support links to reference.
The Postman app utilizes hardware acceleration, meaning it will use your computer's GPU to render screen graphics. In some specific cases, your computer's GPU, drivers, hardware, or operating system may cause issues with hardware acceleration. For example, you may see issues with screen artifacts or glitching. If this occurs, you can disable hardware acceleration.
You can disable Postman's use of GPU acceleration by clearing the Hardware Acceleration option in the Postman menu in MacOS, or the Help menu in Windows or Linux. Changing this option will restart the Postman app. Note that disabling hardware acceleration may cause degraded performance or increased CPU usage.