# Environments

## **Setup Environments**

{% embed url="<https://youtu.be/qczLGoHC6FY>" %}

### **Accessing the Environments Section**

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FkOkPJZVV63g3lkHQSXbX%2Fimage.png?alt=media&#x26;token=02087118-c285-4c6b-b176-2fca6be2a366" alt=""><figcaption></figcaption></figure>

* First, navigate to the **Settings** menu (gear icon) on the left sidebar.
* In the **Project** settings section, select **Environments**. This will bring you to the Environment management page, where you can create and manage different environments, such as staging, testing, or production.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FXlxVlAYw2SlABB5LgGfK%2Fimage.png?alt=media&#x26;token=c8e55037-6380-4b9d-803f-15fb34b95d7a" alt=""><figcaption></figcaption></figure>

***

### **Creating a New Environment**

* On the **Environments** page, click on **+ New environment**. This opens the environment setup popup, where you can configure the details for your new environment.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FwVv9oVg76eulo6s1NUOF%2Fimage.png?alt=media&#x26;token=25389458-e9a6-49f6-a06d-f38073d9bda3" alt=""><figcaption></figcaption></figure>

***

### **Configuring Environment Details**

In the **Edit environment** popup, fill in the following fields:

* **Icon & Color**: Choose an icon and color to visually distinguish this environment.
* **Name**: Enter a descriptive name, such as "Staging," "Production," or "QA."
* **Domains**: Add one or multiple domains associated with this environment. Separate domains by spaces, or press Enter after each domain. Domain rules here follow the same logic as the “[on filtered URL](https://help.usejimo.com/docs/publish/target-specific-urls-domains-where#domain-based-targeting)” in the **Where** field of Target and Publish settings. You can also use regular expressions (e.g., `\.*bar.com$` to match all subdomains ending with bar.com).
* **Description**: Optionally, add a description for this environment to clarify its purpose or content.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2F9HHn7iqS4WRfToVcTEhp%2Fimage.png?alt=media&#x26;token=3e1af304-5dde-4300-bd9b-f1511925d3df" alt=""><figcaption></figcaption></figure>

*Tips on Domain Entry*:

* Single Domain Example: `foo.com`
* Multiple Domains: `foo.com bar.com`
* Regex Matching: `\.bar.com$`

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FtXA7umt2DhNnI4JjE6nu%2Fimage.png?alt=media&#x26;token=f4073736-e60a-4e9b-91e6-b85caaca8bba" alt=""><figcaption></figcaption></figure>

***

### **Viewing and Managing Created Environments**

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FEdXOtvLlPnV4fM2iqBLC%2Fimage.png?alt=media&#x26;token=22aa4e3e-4c89-4e11-873c-d50502a047a2" alt=""><figcaption></figcaption></figure>

Once your environment is created, it will be displayed on the **Environments** dashboard with the chosen icon, name, and associated domains. To view details or make changes, click on the environment tile, and select the **three-dot menu** to either **Edit** or **Delete** the environment.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FCQ5yc4EmxeJFRvFQEUYb%2Fimage.png?alt=media&#x26;token=2e8460b0-315c-48e8-b3fe-0bb16d3b56e7" alt=""><figcaption></figcaption></figure>

***

## Using Environments

### **Target & Publish Settings**

After creating environments, they are available within the **Target and Publish** settings of any experience. When you hit **Publish**, the **Env** selection dropdown (defaulted to "All domains") will automatically appear, allowing you to choose the specific environment(s) where the experience will be published. This ensures that your experience is live only on the domains associated with the selected environment(s).

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FubvKtJ6MuNVK2mdBkd18%2Fimage.png?alt=media&#x26;token=c1fa2dd0-79b0-4125-bb32-f1133fd8f505" alt=""><figcaption></figcaption></figure>

*Example:* If you have "Staging" and "Production" environments set up, you can choose to publish an experience to either or both environments directly from this dropdown.

***

### **Quick Access in Experience Details**

If you need to adjust the environment settings for an experience after it’s been published, you can do so from the **experience details page**.&#x20;

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FF8CSsUUqMSon1nF32Xyj%2Fimage.png?alt=media&#x26;token=c2c3e2ab-9566-4165-91ad-88418bc0ef48" alt=""><figcaption></figcaption></figure>

Open any experience in the dashboard to access its details (**A**) and use the **Env** dropdown in the top-right corner to quickly change the environment(s) on which the experience is active without needing to republish.&#x20;

{% hint style="info" %}
Additionally, you can filter experiences by environment using the **Environments** filter dropdown (**B**) to display only experiences associated with a selected environment.
{% endhint %}

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FfkfCsKyxMd6tOglEWD1A%2Fimage.png?alt=media&#x26;token=8ca3af98-3842-447b-8412-df4a8468db50" alt=""><figcaption></figcaption></figure>

*Example:* If you initially published an experience on "Staging" and now want to move it to "Production," simply select "Production" from this dropdown.

***

{% hint style="warning" %}

### **Use Complementary Filters**

When using the **Where** settings for specific URL filtering, note that these settings act as additional filters on top of the environment selection. If you apply a domain in the **Where** filter that is not included in the selected environment(s), the experience will not display on that domain. **Environments** and **Where** filters need to be configured to work in harmony to ensure accurate targeting.

*Example:* If you target a specific URL under the "Where" filter but select an environment that does not include that URL’s domain, the experience will not be shown.

{% endhint %}
