Docs
Reference

Netlify

Move environment variables to and from one Netlify site.

Move environment variables to and from one Netlify site.

The connection

WhatThis provider
VendorNetlify
Keynetlify-env
Availabilityavailable. You can connect it today.
Credential penv holdsnetlify-token
Values read backyes
Activationon-next-deploy

What it moves

DirectionWhat it does
importReads names and values out of the store into penv.
exportWrites names and values from penv into the store.

When a written value goes live

on-next-deploy. A new value waits there and arrives with your next deploy.

What happens to a name that exists

DirectionPolicies you can pick
importskip_existing, new_version, fail
exportcreate_only, overwrite, overwrite_and_prune

How syncs work says what each one does.

How you connect

You paste a credential you already hold. penv seals it and never shows it again.

FieldLabelKindRequiredWhat it is
tokenAccess tokensecret, masked here and sealedyes

What the connection asks for

Fixed when you connect, and shared by every mapping on it.

FieldLabelKindRequiredAdvancedWhat it is
accountIdTeamtextyesnoThe team slug from your Netlify URL. Verify checks the token actually reaches it.

What a mapping asks for

Answered once per environment you map.

FieldLabelKindRequiredAdvancedWhat it is
siteIdSitetextyesnoSite settings → General → Site ID. Every value stays scoped to this one site.
contextDeploy contextchoiceyesyesOther contexts on the same variable are left untouched. One of Production, Deploy previews, Branch deploys, Dev, Dev server. Starts at production.
scopesWhere it is readablechoiceyesyesNarrows where new variables are readable. Netlify sets this once, at creation. One of Everywhere (Netlify's default), Builds only, Functions and runtime. Starts at all.

Permissions it needs

penv probes for these when it verifies the connection.

PermissionDirectionsBlockingWithout it
accounts:readevery directionyesWe cannot confirm this token reaches the team you named.
env:readimportyesImport cannot read variable values.
env:writeexportyesExport cannot write anything.