Manage environments

An environment is a set of key-value pairs. The key represents the name of the variable. You can use a data editor to modify an environment.

This topic describes how to create, select, edit, and share an environment.

Creating a new environment
Selecting an active environment
Editing an active environment
Sharing an environment

Creating a new environment

You can create a new environment from the:

Manage Environments icon
New button
Launch screen

Manage environments icon

Click the “Manage Environments” icon in the upper right corner of the Postman app.

Select “Manage Environments”.

Click the Add button.

New button

In the header toolbar, click the New button.

Click “Environment” and enter a name for the new environment.

Add the variables you want to save as key-value pairs.

Click the Add button.

Note: At the bottom, you can select “Show this window at launch” to indicate whether you want the Create New tab to display each time you open Postman.

Launch screen

The Create New tab appears by default when you launch Postman.

Open the Postman app.

In the Create New tab, click “Environment”.

Enter a name for the new environment.

Add the variables you want to save as key-value pairs.

Click the Add button.

Note: At the bottom, you can select “Show this window at launch” to indicate whether you want the Create New tab to display each time you open Postman.

Selecting an active environment

Click the dropdown menu in the upper right corner of the Postman app to select an active environment, or type in the environment name.

Once you select an environment, you can access variables in the active environmental scope.

Editing an active environment

Click the Quick Look icon in the upper right corner of the Postman app to display the environment and global variables.

When you click the “Edit” link, a modal opens where you can edit keys and values.

To share an environment, click the gear icon in the upper right corner of the Postman app and select “Manage Environments”.

In the Manage Environments tab, click the Duplicate Environment icon next to the environment you want to share.

It’s best practice to create a duplicate, remove any sensitive values (such as passwords), and access tokens before downloading the copy to share with others.

When others import the environment or access the shared template, they can input their own personal information in their own version of the template.

Note: For Pro and Enterprise users who share environments in a workspace, be aware that changes made to a shared environment will sync for the entire team. If you have sensitive credentials that you don’t want to expose, create a duplicate of the environment, remove the sensitive values, before uploading to share with others.

For Postman Pro and Enterprise users, learn how to share environment templates with team members.

For more information about variables and globals, see:

Variables Manage globals

Manage globals