---
title: Custom environments for EAS Environment Variables
authors: Kadi Kraman
published: November 21, 2025
---

By default, all projects have three environment variable environments: **development**, **preview**, and **production**. This setup works well for most hobby and small projects, but we've heard from larger teams and those with more complex workflows that they need additional flexibility. We're excited to announce that we've just shipped the ability to configure custom environments! This feature is available on all Production and Enterprise plans.

## How it works

When creating an environment variable, click on the `+` icon next to Environments, and enter a custom environment name for the variable. Once this variable has been created, subsequent variables will have the new environment - in this case **test** - listed as available environment.

To delete a custom environment, delete all environment variables assigned to it.

![Example of defining a custom environment](https://cdn.sanity.io/images/9r24npb8/production/2244c6f7bf5800b47652f7f916f9958f08c00b7b-1610x1428.png)

## With the `eas-cli`

Custom environments support was added in `eas-cli@16.23.0`. In practice this means that the `--environment` flag now accepts any string as opposed to only the default **development**, **preview** and **production.**

![Terminal example listing all the env vars for the test environment](https://cdn.sanity.io/images/9r24npb8/production/618eb8eb54ef9e656841a2ff692e240ba5302315-892x292.png)

Now you may pass in `test` as the `environment` field in **eas.json** or workflows files which will ensure the build will pull variables from the new environment.

![Example of using a test environment in build](https://cdn.sanity.io/images/9r24npb8/production/26b0fced632960b1ecb18d4f2f92493febc56894-820x430.png)

## Limits

- An environment name can contain letters, digits, underscores and hyphens, and be between 3-100 characters
- Project environment variables are limited to 200 per environment
- App-wide environment variables are limited to 150 per environment
- Custom environments are limited to 10 per project

If you have a use-case that exceeds these limits, [please get in touch](https://expo.dev/contact)!