Pin environments to collections

You can pin environments to an HTTP collection to organize your workspace and show other Postman users which environments work with that collection. If a user forks the collection, pinned environments will fork with the collection. By associating environments with collections, pinning helps other users understand and consume your requests.

Pin an environment to a collection

You can pin environments to help users identify the environments they should use with requests in your collection. You can set one environment as the default pinned environment that's automatically selected as the active environment when users open the collection.

To pin an environment to a collection, do the following:

  1. Click a collection, folder, or request.

  2. Click the environment selector in the upper right of the workbench.

    You can hover over an environment and click Open in Postman icon Open environment to open it in a new tab.

  3. Hover over an environment and click Pin icon Pin to collection. The pinned environment appears at the top of the environment selector. You can pin multiple environments to a collection.

To unpin an environment from a collection, hover over a pinned environment, click Options icon View more actions, and then click Unpin.

When you fork a collection that has pinned environments, Postman automatically forks the pinned environments with the collection. Postman makes the default pinned environment the active environment in your forked collection. To learn more, see Fork collections and environments in Postman.

Set a default pinned environment

When you or another user opens the collection, Postman automatically makes the default pinned environment the active environment. This helps other users see which environment to start with when working with your collection. Your collection can only have one default pinned environment at a time.

Postman automatically sets the first pinned environment in your collection as the default pinned environment.

To set a default pinned environment for a collection, do the following:

  1. Click a collection, folder, or request.
  2. Click the environment selector in the upper right of the workbench.
  3. Pin the environment, if you haven't already.
  4. Click Options icon View more actions, then click Set as Default. The default pinned environment has the label DEFAULT.

When you fork a collection that has a default pinned environment, Postman automatically makes it the active environment in your forked collection.

If you unpin the default pinned environment, the next pinned environment in the list will become the default pinned environment for the collection.

Last modified: 2025/03/28