Reference
Netlify
Move environment variables to and from one Netlify site.
Move environment variables to and from one Netlify site.
Connection
| What | This provider |
|---|---|
| Vendor | Netlify |
| Key | netlify-env |
| Availability | available. You can connect it today. |
| Credential we hold | netlify-token |
| Values read back | yes |
| Activation | on-next-deploy |
Directions
| Direction | What it does |
|---|---|
import | We read names and values out of the store into your environment. |
export | We write names and values from your environment into the store. |
Activation
on-next-deploy. A new value waits there and arrives with your next deploy.
Conflict policies
| Direction | Policies you can pick |
|---|---|
import | skip_existing, new_version, fail |
export | create_only, overwrite, overwrite_and_prune |
How syncs work says what each one does.
Connect
Paste a credential from the vendor. We seal it and never show it again.
| Field | Label | Kind | Required | What it is |
|---|---|---|---|---|
token | Access token | secret; we mask it here and seal it | yes |
Connection fields
You set these when you connect. Every mapping on the connection shares them.
| Field | Label | Kind | Required | Advanced | What it is |
|---|---|---|---|---|---|
accountId | Team | text | yes | no | The team slug from your Netlify URL. Verify checks the token actually reaches it. |
Mapping fields
You answer these once per environment you map.
| Field | Label | Kind | Required | Advanced | What it is |
|---|---|---|---|---|---|
siteId | Site | text | yes | no | Site settings → General → Site ID. Every value stays scoped to this one site. |
context | Deploy context | choice | yes | yes | We leave other contexts on the same variable untouched. One of Production, Deploy previews, Branch deploys, Dev, Dev server. Starts at production. |
scopes | Where it is readable | choice | yes | yes | Narrows 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. |
Required permissions
We probe for these when we verify the connection.
| Permission | Directions | Blocking | Without it |
|---|---|---|---|
accounts:read | every direction | yes | We cannot confirm this token reaches the team you named. |
env:read | import | yes | Import cannot read variable values. |
env:write | export | yes | Export cannot write anything. |