Get startedInstall and configureSettings

General settings

View as Markdown

Use the settings on the General tab to configure how Postman sends requests or to customize the Postman user interface.

Request

  • HTTP Version - Select the HTTP version to use when you send requests. This enables you to test and debug requests by HTTP version. You can also specify the HTTP version for an individual request. Learn more about specifying an HTTP version.
  • Request Timeout - Enter how long (in milliseconds) Postman will wait for a response before timing out. If you enter 0, Postman will wait for a response forever.
  • Max response size - Enter the largest response size (in megabytes) that Postman will download. For responses that exceed this limit, Postman asks if you want to increase the size limit or download the response. If you enter 0, Postman downloads responses of any size. Rendering large responses may affect Postman’s performance.
  • SSL certificate verification - Turn this off to prevent Postman from checking the validity of SSL certificates when making requests.
  • SSL/TLS key log - Turn this on to enable SSL/TLS session key logging for debugging encrypted connections. You can export a SSLKEYLOGFILE and use it to decrypt secure traffic locally for inspection with tools like Wireshark.
  • Disable cookies - Turn this off to stop using the Postman cookie jar.
  • Response format detection - By default, Postman automatically detects the correct media type for the response body based on the Content-Type header. Select JSON to always use JSON rendering for the response body.

Working directory

Set your working directory to ensure that requests in shared collections always work. As long as you and your teammates use the same files and working directory location, shared requests will run across everyone’s systems. Learn more about setting your working directory.

Headers

  • Send no-cache header - (Recommended) Turn this on to send a Cache-Control: no-cache header with each request. The no-cache directive forces the server to revalidate each request and ensures you get an up-to-date (not stale) response.
  • Send Postman Token header - (Recommended) Turn this on to send a random Postman token with an XMLHttpRequest. Sending a random token ensures the receiving server handles one request at a time, even when the requests send with the same parameters. The token can also aid debugging and help you distinguish between requests on the server side.
  • Retain headers when clicking on links - When you click a link in a response, Postman creates a new GET request with the link URL. Turn this on to keep the headers from the earlier request in the new request. Retaining headers is useful if you mainly access protected resources.
  • Automatically follow redirects - Turn this off to prevent requests that return a 3xx series response from automatically redirecting.

User interface

  • Remove tabs - (Postman web app) Use tabs in your browser to navigate Postman instead of in-app tabs. For more information, see Browser tabs in the Postman web app.
  • Always open sidebar item in new tab - By default, when you click a sidebar item, Postman opens it in the preview tab. Turn this on to always open sidebar items in a new tab.
  • Always ask when closing unsaved tabs - By default, Postman asks if you want to save any unsaved changes when closing a tab. Turn this off to always discard unsaved changes when closing a tab.
  • Show icons with tab names - Turn this off to hide the icons that appear next to tab names.
  • Two-pane view - By default, Postman displays responses below requests. Turn this on to display the response and request panes side by side.
  • Variable autocomplete - Turn this on to enable autocomplete when typing variable names.
  • Default documentation editor - Select the default editor you want to use for editing documentation descriptions in Postman (Postman editor or Markdown editor).

Editor settings

Editor settings affect code-related text such as request and response bodies, pre-request scripts, and tests. To revert to default text settings, click Reset.

  • Font family - Enter one or more font family names separated by commas. Postman uses the first available font family to display code text.
  • Font size - Enter the font size in pixels to use for code text.
  • Indentation count - Enter the number of indentation characters to use for each code level.
  • Indentation type - Select the indentation character type to use (Space or Tab).
  • Auto close brackets - Turn this on to automatically add a closing bracket when you enter an opening bracket.
  • Auto close quotes - Turn this on to automatically add a closing quotation mark when you enter an opening quotation mark.

Application

  • Open in desktop app - Automatically open workspace-related links in the Postman desktop app. If not turned on, links open in the browser.

  • Language - Select your preferred language for the Postman app and email notifications.

  • Autosave - Turn this on to automatically save your changes to requests. Turn this off to manually save your changes.

    This feature is available on Postman Free, Solo, and Team plans. For more information, see the pricing page.

If autosave is turned on, and you create a request by clicking Add icon Add or by clicking New in the workbench, you must manually save the request to a collection before your changes are autosaved.

  • Send anonymous usage data to Postman - Postman gathers basic, anonymous usage data to help with product improvement. Turn this off to stop sending anonymous usage data to Postman.
  • Connection Mode - Configure automatic or HTTP connection from your Postman client to the Postman servers.