Skip to main content

Managing Environment Variables

  • Updated

Environment variables allow you to provide environment specific configurations for your Gatsby site. A typical use case for environment variables is to provide secret API tokens to your application without having to hard code values in your source code.

When working with Gatsby Cloud you will have two environments you can configure for:

  1. Deploy Builds and Deploy Previews
  2. CMS Previews

This guide covers how to set environment variables and assumes you already have your site created.

 

Setting Environment Variables

Environment variables can be accessed via the dashboard menu by clicking Site Settings > General > Environment Variables.

env_vars.png

Click the Edit Variables icon to add or update variables. The first field is the variable name and the second field is the value.

  • Build variables apply to Deploy Builds and Deploy Previews
  • Preview variables apply to CMS Previews

edit_vars.png

When you are done editing both your Builds and Preview variables, click Save to confirm changes.

Note: Editing environment variables triggers a new build of your site.

 

Bulk Add Variables

As a convenience, you can add environment variables in bulk by clicking the Bulk Add Variables button. Supply your variables in the format name=value entering each variable on a new line.

Variables added in bulk do not overwrite existing variables, they are appended to the current list. However, you can delete the old variables after you have added the new ones.

env_var_bulk.png

Accessing Environment Variables

The environment variables you set can be accessed in source code by referencing process.env.<variable name>. For example:

const contentfulConfig = {
  spaceId: process.env.CONTENTFUL_SPACE_ID,
  accessToken: process.env.CONTENTFUL_ACCESS_TOKEN,
};

if (process.env.CONTENTFUL_HOST) {
  contentfulConfig.host = process.env.CONTENTFUL_HOST;
}

Related articles