--- title: "How to Contextualize your env vars with Netlify Build Plugins" description: "How can build plugins can optimize your code for maximum efficiency in production? In this tutorial, learn how to localize your env vars by context. Check it out!" source: "https://www.netlify.com/blog/2020/05/21/localize-your-environment-variables-by-context-with-build-plugins/" last_updated: "2026-07-11T00:33:01.000Z" --- In general, a staging environment doesn’t always have the same context as a production environment. Most commonly, this difference manifests in how we handle and account for environment variables. In the context of a Netlify build, accounting for this difference means making sure you’re checking the context and using the associated environment variable. This can mean manually checking the context in every build and swapping out the environment variable appropriately. In a serverless function, this would look something like this: ``` exports.handler = function(event, context, callback) { const context = process.env.CONTEXT let DB_KEY; if (context === "production") { DB_KEY = process.env.DB } else if (context === "deploy-preview" || context === "branch-deploy") { DB_KEY = process.env.STAGING_DB }} ``` Having to do this for every Netlify project is not only burdensome, it can lead to unexpected errors if not configured well. Thankfully, with the help of build plugins, we can access and modify environment variables on the fly without having to repetitively account for differences in context. To illustrate the process of modifying environment variables, let’s walk through an example plugin where we re-write the process.env variable based on context. ## Let’s build a plugin To start, let’s create a plugin folder in our project root that we’ll use for our build. ``` plugins/ netlify-plugin-env-var-by-contextsrc/... ``` We’ll now add our plugin to our build configuration so that it refers to this particular plugin. ``` [[plugins]]package = "./plugins/netlify-plugin-env-var-by-context" ``` With this configuration, we can now move onto building our plugin. ### Configuration Because we want to pick up our environment variables and modify them at the beginning of the build, we’ll be using the `onPreBuild`hook. To start let’s identify the context or branch that our code is run in. In a Netlify build, you can access and configure a site’s build by context with the help of [deploy contexts](https://docs.netlify.com/site-deploys/overview/#deploy-contexts). These contexts give you the flexibility to fine-tune your build so they adapt to the specific context they’ve been deployed to. From our configuration, we access the deploy context from the `CONTEXT` attribute in `process.env`. This will yield one of three deploy contexts, `production`, `deploy-preview` and `branch-deploy`. ``` module.exports = { onPreBuild: async ({ inputs }) => { const { CONTEXT } = process.env; // CONTEXT === "production" OR // CONTEXT === deploy-preview OR // CONTEXT === branch-deploy },}; ``` Assuming we’ve namespaced our environment variables appropriately using the above mentioned deploy contexts, i.e. `DEPLOY_PREVIEW_DB_KEY`, we can move on to identifying and setting environment variables appropriately. The goal of our build plugin is to re-write a specific `process.env` variable so that we no longer need to write lengthy if statements to handle various contexts. In other words, we should be able to dynamically swap out the `process.env` variable pre-build. To do this, we’ll iterate through all `process.env` variables and find ones matching the specific context, so if we’re in a `deploy-preview` context, we’ll grab a `process.env` like `DEPLOY_PREVIEW_DB_KEY`; The assumption here is that contexts are prefixed. With the context specific environment variable identified, we will grab the specific environment variable and set it to the base process.env variable. This means that in a context of `deploy-preview` all references to a `process.env.DB_KEY` will be swapped out for the `process.env.DEPLOY_PREVIEW_DB_KEY` variable. ``` module.exports = { onPreBuild: async ({ inputs }) => { const context = process.env.CONTEXT.toUpperCase().replace(/-/g, '_'); Object.keys(process.env).forEach(key => { const envVar = `${context}_${key}` const val = process.env[envVar] if (process.env[envVar]) { console.log(`Exporting ${key}=${val}.`); process.env[key] = val } }); },}; ``` With this build plugin in place, we can now refer to the specific environment variable without its corresponding context, which saves us from having to write pesky conditionals. ## The wonderful world of build plugins If you’d rather not write your own build plugin, there is a plugin called `netlify-plugin-contextual-env` written by [Chris Ball](https://github.com/cball) that does this exact thing. To use his plugin, simply add it to your config file like so: ``` [[plugins]]package = "netlify-plugin-contextual-env" ``` Build plugins provide keen access into the deployment process and are handy ways to augment your builds pre-deploy. By offering direct access to the various stages of Netlify’s build, build plugins gives developers fine grained control over how code gets shipped and distributed to end users. To get started with build plugins, head on over to the [Netlify docs on build plugins](https://docs.netlify.com/configure-builds/build-plugins/). Happy building! ### Share - [X (fka Twitter)](https://twitter.com/intent/tweet?text=Localize your environment variables by context with build plugins &url=https://www.netlify.com/blog/2020/05/21/localize-your-environment-variables-by-context-with-build-plugins//) - [LinkedIn](https://www.linkedin.com/shareArticle?mini=true&url=https%3A%2F%2Fwww.netlify.com%2Fblog%2F2020%2F05%2F21%2Flocalize-your-environment-variables-by-context-with-build-plugins%2F%2F) - [Facebook](https://www.facebook.com/sharer.php?u=https://www.netlify.com/blog/2020/05/21/localize-your-environment-variables-by-context-with-build-plugins//) - [Bluesky](https://bsky.app/intent/compose?text=Localize your environment variables by context with build plugins +https://www.netlify.com/blog/2020/05/21/localize-your-environment-variables-by-context-with-build-plugins//) ## Keep reading ![](/images/blog-fallback-thumbnail.svg) Guides & Tutorials April 30, 2020 [ ### What’s a Netlify Build Plugin Series: Part 1 - Using Build Plugins ](/blog/2020/04/30/whats-a-netlify-build-plugin-series-part-1-using-build-plugins) - ![Profile picture of Tara Z. Manicsic](/_astro/2ac74d0595066130d59f8c97e61332017cdbcb94-1000x921_ZyTafG.webp) Tara Z. Manicsic ![](/images/blog-fallback-thumbnail.svg) Guides & Tutorials May 20, 2020 [ ### What's a Netlify Build Plugin Series: Part 2 - Making Build Plugins ](/blog/2020/05/20/whats-a-netlify-build-plugin-series-part-2-making-build-plugins/) - ![Profile picture of Tara Z. Manicsic](/_astro/2ac74d0595066130d59f8c97e61332017cdbcb94-1000x921_ZyTafG.webp) Tara Z. Manicsic ## Recent posts News & Announcements June 25, 2026 [ ### Netlify Functions, designed for Agent Experience ](/blog/netlify-functions-designed-for-agent-experience) - ![Profile picture of Eduardo Bouças](/_astro/52958f21e8450baf6d8e60302341a984e220c0cd-512x512_13VDlu.webp) Eduardo Bouças News & Announcements June 24, 2026 [ ### How we measure Netlify’s Agent Experience ](/blog/how-we-measure-netlify-agent-experience) - ![Profile picture of Sean Roberts](/_astro/bbf2243f8171dbddd80ab2103622106cef84d125-512x512_Z1d2LKE.webp) Sean Roberts Guides & Tutorials May 15, 2026 [ ### How to build a real-time AI chatbot in minutes with Netlify Agent Runners (no backend) ](/blog/how-to-build-a-real-time-ai-chatbot-in-minutes-with-netlify-agent-runners-no-backend) - ![Profile picture of Nahrin Jalal](/_astro/f0e7c8f227a03fe58340c99ef5439d5a896c0733-272x272_Z23kDpD.webp) Nahrin Jalal ![](/_astro/3f255b372fa958df35802666ee33b4609b2d71bd-1200x1586_1VtE2D.webp) ### How do the best dev and marketing teams work together? [Access the report](https://www.netlify.com/reports/2024-leadership-trend-report/access/)