Environments

An environment allows you to group together a set of variable data. You can reference the variable data you define in an environment throughout Hoppscotch 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

Hoppscotch environment provides support for two types of variables

1. A Regular environment variable allows users to reference the variable throughout Hoppscotch, 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 Hoppscotch will be masked using asterisks (***).

<Tip>Secret variables values will not be exported when an environment is exported.</Tip>

Types of Values in an Environment

An environment variable can have two types of values:

1. Initial Value - The initial value of the variable when it is created. This value is used when the environment is first loaded.
2. Current Value - The current value of the variable, which can be modified at any time. This value is used when the environment is active.

Shared Environment Access

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.

<Note> Secret variable values will not be copied to the duplicated environment. </Note>