> For the complete documentation index, see [llms.txt](https://help.usejimo.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.usejimo.com/docs/settings/environments.md).

# Environments

Reference for Settings > Environments: named lists of domains, the fields of an environment, and the Env selector on each experience.

An environment is a named list of domains, such as Staging or Production. When you publish an experience, you pick its environments, and it runs only on their domains.

{% hint style="info" %}
**What to type in Domains, and how environments differ from Where:** see [Environments and domains](https://help.usejimo.com/docs/getting-started/your-workspace/environments-and-domains.md) in Getting started. That page is the reference for the matching rules; this one covers the screen.
{% endhint %}

## Where to find it

**Settings > Environments** (`/settings/environments`) lists the project's environments as tiles, with their icon, name and domains. The guided setup created one, **Production**, from your app domain.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FPgetjpa2qyzKVV3id9Va%2FE2-s07-environments.png?alt=media&amp;token=93daffb3-c6f9-4b13-95de-b1e5499d7ef4" alt="Settings, Environments: the + New environment button (A) and an environment tile with its icon, name and domain (B)"><figcaption></figcaption></figure>

## Fields of an environment

Click **+ New environment** to create one. Click an existing tile to open its details: icon, name, number of domains, description and domains. The three-dot menu of the details lets you **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%2FIkgvKWFr3Jd1IhFXw9js%2FE2-r02-environment-details.png?alt=media&amp;token=d53a04db-c8e5-49e6-8010-246361e63dd9" alt="Details of an environment, opened from its tile: icon (A), name with its number of domains (B), description (C), domains (D) and the three-dot menu to edit or delete it (E)"><figcaption></figcaption></figure>

| Field              | What it does                                          | Effect on your users                                 |
| ------------------ | ----------------------------------------------------- | ---------------------------------------------------- |
| **Icon and color** | Tells environments apart in the dashboard             | None                                                 |
| **Name**           | Label shown in the Env selector at publish time       | None                                                 |
| **Domains**        | Host names, or a regular expression, where it applies | Experiences published to it show on these hosts only |
| **Description**    | Optional note on what the environment is for          | None                                                 |

#### Icon and color

Tell environments apart at a glance in the dashboard.

#### Name

Shown in the Env selector at publish time. Use the words your team uses: Staging, Production, QA.

#### Domains

One or several host names, separated by spaces or with Enter after each, or a regular expression. Host names only: no `https://`, no path. Examples and pitfalls in [Environments and domains](https://help.usejimo.com/docs/getting-started/your-workspace/environments-and-domains.md#what-the-domains-field-accepts).

#### Description

Optional. A note on what the environment is for.

## Using environments

#### At publish time

When you publish, the **Env** selector lets you pick one or several environments. Its default is **All domains**, which matches every domain where the snippet runs, including a developer's `localhost`. Once you have named environments, publish to them rather than to All domains.

#### After publishing

Open the experience's details in the dashboard. The environment dropdown at the top right shows the current choice, **All domains** by default. Open it: the **Select environment(s)** list shows All domains and the project environments. Tick the ones you want and click **Update**. The change applies without republishing: this is how you move an experience from Staging to Production.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FxpNmg41IowDAmnJanSOg%2FE2-03-switch-environment.png?alt=media&amp;token=fa7dc38a-5838-4af6-a9d5-59e1e1c4015c" alt="An experience published to Staging moves to Production by switching its Env, with no republish"><figcaption></figcaption></figure>

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2Fu2AitvmZ9bU53oi6DJgV%2FE2-s08-experience-env-dropdown.png?alt=media&amp;token=49b2e745-7268-48f9-a4c1-9c3aaf89062b" alt="Experience details: the environment dropdown at the top right (A), the Select environment(s) list with All domains ticked (B), and the publish status above the Update button (C)"><figcaption></figcaption></figure>

#### Filter the experience list

The **Environments** filter on the experience list shows only the experiences of the environments you pick.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2F4CS1HdcoB6aQUOYQHGVQ%2FE2-s09-list-environments-filter.png?alt=media&amp;token=d47a7fd3-87ba-4b67-8342-e8fb63eee6d1" alt="Experience list with the Environments filter open, listing the project environments to pick from (A)"><figcaption></figcaption></figure>

## Environment and Where together

The environment scopes the host; [Where](https://help.usejimo.com/docs/publish/target-specific-urls-domains-where.md) scopes the path. A Where rule that names a domain outside the selected environments matches nothing, and the experience never shows. Leave the domain out of Where when an environment is selected. Detail in [Environments and domains](https://help.usejimo.com/docs/getting-started/your-workspace/environments-and-domains.md#environment-versus-where).

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FyHud0E3VpsxlXiBbNjQU%2F07-environment-vs-where.png?alt=media&amp;token=58e8984b-6919-46e7-ab18-3e2a6a0e50ab" alt="The host picks the environment, the path is matched by Where"><figcaption></figcaption></figure>

**From your assistant:** "Which environments does my project have, and which domains are in each?" See [What to ask](https://help.usejimo.com/docs/integrations/mcp/what-to-ask.md).

## Who can change this

Members whose role gives access to the project settings. A change to an environment's domains applies at once to every experience published to it.

## Verify

Publish a test experience to one environment only, open your app on a domain of that environment: it shows. Open a domain of another environment: it does not. If it does not show where it should, see [Why my experience does not show](https://help.usejimo.com/docs/getting-started/publish-your-first-experience/why-my-experience-does-not-show.md).

## Go further

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>Environments and domains</strong></td><td>What the Domains field accepts, staging first, one project or several.</td><td><a href="https://help.usejimo.com/docs/getting-started/your-workspace/environments-and-domains.md">Environments and domains</a></td><td><a href="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FXq4ivtUAniYTF4lAunZL%2FE2-c06-environments.png?alt=media&amp;token=807cf841-7d89-4813-aa16-39923b9e3970">E2-c06-environments.png</a></td></tr><tr><td><strong>Where</strong></td><td>Target pages by path, query and hash, on top of the environment.</td><td><a href="https://help.usejimo.com/docs/publish/target-specific-urls-domains-where.md">Where: target pages and domains</a></td><td><a href="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FZLxmjoXNU7FBixjrg1SU%2FB-c02-where.png?alt=media&amp;token=74c652d4-26b2-4dc7-a220-9c502ea1737b">B-c02-where.png</a></td></tr><tr><td><strong>Test safely</strong></td><td>Publish to yourself first, then widen.</td><td><a href="https://help.usejimo.com/docs/getting-started/publish-your-first-experience/test-safely.md">Test safely</a></td><td><a href="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FPt2g9eOv7NR2Rh7mC7u1%2FE2-c09-troubleshoot.png?alt=media&amp;token=214a280d-2970-418d-9539-0b27f183c718">E2-c09-troubleshoot.png</a></td></tr></tbody></table>

**Next page:** [Team management](https://help.usejimo.com/docs/settings/team-management.md)
