Skip to main content

​
Location of project configuration

Each project in Mage has a metadata.yaml configuration file located in the project’s root directory. For example, if you had a project called your_project, the folder structure for that project might look something like this:

​
Override project config based on environment

In the project’s metadata.yaml config file, add an overrides key at the top-level (no indentations) with the name of your environment (e.g. prod, dev, test) under the overrides key and indented once. Then under the environment name key, add the properties of your base project config that you want to override. Make sure the indentations of the properties match those of the base config. Any environment-specific overrides will REPLACE the matching property in the base config, so be careful when overriding properties with nested values.
The environment name should match the environment defined in the ENV environment variable.

​
Example project config file with environment overrides

In the example above when in the dev environment, the project’s nested configuration property of save_in_code_automatically will be overridden to be false (instead of true as defined in the base config). The other properties (i.e. help_improve_mage, automatic_kernel_cleanup, and global_hooks) will also be overridden. Other environments (not dev) will not utilize the overrides section.