An environment allows you to group together a set of variable data. You can reference the variable data you define in an environment throughout Postdata when sending requests or using scripts. Environments are also useful when you need to manage shared variables with a team. You can create environments and share them with your workspace members.

​
Types of Environments

  1. Global Environment - Variables defined in a global environment can be accessed from any workspace anytime. However the variables defined in a personal or shared workspace environment if used will have higher precedence over a global variables
  2. Personal Environment - Are personal to the user and is not associated with a shared workspace, however a user can use a personal environment in a shared workspace without sharing it with the workspace members
  3. Shared Environments - Are unique to each shared workspace, all the shared environments created in a shared workspace are accessible to every member of the shared workspace

​
Types of Variables in an Environment

Postdata environment provides support for two types of variables
  1. A Regular environment variable allows users to reference the variable throughout Postdata, and anyone can see the value associated with the variable. In a shared workspace, regular environment variable-value pairs will be synced to the server, making them available to all workspace members. However, you have the option to choose whether to sync a personal or global environment.
  2. A secret environment variable enables users to specify secrets and reference the values as variables. The values of secret variables in any workspace will never be synced to the server or shared with any workspace members. It is expected that the user will populate the value of the variable at runtime. All secret variable values in Postdata will be masked using asterisks (***).
Secret variables values will not be exported when an environment is exported.

​
Shared Environment Access

Environment VariableSecret Variable
Workspace Ownercreate / delete variable, edit value and usecreate / delete secret variable, add values and use
Workspace Editorcreate / delete variable, edit value and usecreate / delete secret variable, add value and use
Workspace Vieweruseadd value and use

​
Creating an environment

Click on the ”Environments” icon on the sidebar to create environments. A variable created in an environment can be used by typing the variable name enclosed in double angle brackets <<variable>>

​
Using scripts

You can also create and delete environment variables using scripts by using the pw object.. 
pw.env.set("variable", "value"); // Creates an environment variable 
pw.env.unset("variable"); // Deletes the environment variable

​
Duplicating an environment

Create a copy of an existing environment to modify or test different configurations without affecting the original:
  1. Click the “Environments” icon in the sidebar to view all existing environments under Global Environments.
  2. Next to the environment you want to duplicate, click the More icon.
  3. From the dropdown menu, select Duplicate. A new environment with the suffix - Duplicate will be created.
Secret variable values will not be copied to the duplicated environment.

Creating environment variables from client

Learn how you can create environment variables from the client.

Creating environment variables using scripts

Learn how you can create environment variables using pre-request scripts.

Read more pre-request script examples

Learn more pre-request script examples.