Manage Environment Variables

Configure and use environment variables in your Wix CLI project to store configuration values and secrets outside of your code. Learn about the types of environment variables available in Wix CLI projects.

Step 1 | Define the schema

In this step, you define the structure of your environment variables in astro.config.mjs, specifying each variable’s type, context (client or server), and access level (public or secret) before assigning actual values.

Read more about the schema definition in the Astro documentation.

Step 2 | Configure environment variables

In this step, you configure public or secret variables.

Configure public client variables

To configure public variables:

1. Add your variables to the .env.local file in your project root.

2. Use the wix env set command to set the variables.

Configure secret server variables

To configure secret server variables:

1. Use the wix env set command to set the secret variable.

2. Pull the secret variables to your development environment using the wix env pull command.

Step 3 | Use environment variables in your code

In this step, you learn how to import and use environment variables.

Use client variables

Import public client variables from astro:env/client. The following example imports and uses the API_URL variable.

Use backend variables

Import public server and secret variables from astro:env/server:

Step 4 | Build and release your project

After setting your environment variables, build and release your project to apply the changes.

To build and release:

1. Build your project.

2. Release your project to apply the changes.

See also

• About Environment Variables
• Build and Deploy a Project