# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.usejimo.com/docs/settings/environments.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
