Tools & Services

Easy Access Environment Variables

Tools & Services

Easy Access Environment Variables

When it comes to handling sensitive information like private keys, there are two scenarios that always come to mind:

  • 😱 adding the important, private values to code that then gets pushed up to GitHub for the world to see
  • 😓 having to wait for a teammate to share the keys before anyone can contribute to a project

I have definitely gone through both of these scenarios and possibly, you have too. When I learned about how Netlify stores project environment variables I realized it was the answer to both of these yucky situations.

Setting Environment Variables

There are three different ways we can set these variables for Netlify projects. My go-to is via the project dashboard in 'Site settings > Build & deploy > Environment > Environment variables'. These variables can be edited and removed with a click of a button.

project dashboard list of environment variable

The same approach can be made in team settings to make environment variables available to all of your projects. This is super handy for information that needs to be shared across multiple projects but they can also be overwritten at the site level. This can be set in the team settings, 'Team settings > Sites > Global site settings > Shared environment variables'.

team settings dashboard

Thirdly, if the variables we want to add aren't private infrormation, we can set environment variables in the Netlify configurations file,netlify.toml(this file gets committed so no privacy here!). The variables can be set to different deploy contexts and this file will override anything set in the UI. Here's an example of what that might look like:


  publish = "dist/my-project"
  command = "ng build --prod"
  environment = { NOT_PRIVATE_STUFFS = "totally not top secret", NODE_VERSION = "14.15.3", API_KEY = "abc1234teeheehee" }

[context.staging] # “staging” is a branch name
  command = "echo 'staging'"
  base = "staging"
  environment = { SOME_KEY = "t0te5Important5tuff" }

Using Environment Variables

Inside of your code, these variables can be referenced by putting process.env. in front of the name of the environment variable. So, if the key is MY_SECRET_SAUCE, the code we call it with will look like this:

const topSecretRecipe = process.env.MY_SECRET_SAUCE;


Such Benefits

Having this information stored on the project dashboard means that you can keep it out of your code completely. It's great when we remember to hold keys in .env files but not so great when we forget to add that file to the .gitignore list. That whole "remembering" thing is very hard and, personally, I prefer to avoid it completely. Storing environment variables this way makes it so computers do all our remembering, the way it should be.

Being your team can access the project's dashboard they are able to add and edit variables. When coding locally you can use ntl dev to serve up the project and the environment variables are automatically added from Netlify. Better still, even when team members don't have access they can look at deploy previews that take advantage of the correct environment variables.

Any Questions?

Interested? Want to learn more? Check out the documentation on build environment variables or our place to get answers, the Netlify Support Forums. There's a lot more you can do with environment variables so check out the docs to learn about:

That's right, your environment variable fun has just begun. Happy coding 👩🏻‍💻!

Keep reading

Recent posts

Book cover with the title Deliver web project 10 times faster with Jamstack enterprise

Deliver web projects 10× faster

Get the whitepaper