What are Environment Tags in Retell AI?
An environment tag is a named pointer that you attach to a version of an agent.
An Environment tag does two jobs at once.
First, it carries a set of environment dynamic variable values.
When the tag is active on a version, Retell injects those values into the agent at call time.
Second, it acts as a movable reference.
You can bind a phone number, an API call, or another integration to the tag instead of to a fixed version number.
When you move the tag to a new version, everything bound to that tag is moved as well. You do not repoint each phone number by hand.
Common tags are prod for your live environment and staging for testing.
The same agent logic can serve both. Live calls hit the version on prod with live data. Test calls hit the version on staging with test data.
You do not duplicate the agent to achieve this.
This guide assumes you already understand versions. If you are new to versions, read the companion guide, Understanding Versioning in Retell AI, first.