Import and export variables
Bring a whole .env into a project with a preview before writing, and download a full environment in the format your deploy consumes.
Import a .env
- 1
On the project matrix, click `Importar variáveis` (Import variables).
The wizard opens in two steps.
- 2
On the `Conteúdo` (Content) step: provide the text and check the `Ambientes de destino` (Target environments).
Drag a file, pick one, or paste the text (1 MiB limit). Each target environment has the
só as chaves (valor vazio)(keys only, empty value) switch, which seeds the structure without copying values — useful to create production gaps from dev. - 3
Click `Pré-visualizar` (Preview) and review the table.
The raw text goes to the server, whose hardened parser (multiline PEM, comments, quotes, BOM, CRLF, duplicates) is the source of truth. The table shows, per key and per environment, the
nova(new),muda(changes), origual(same) badge, plus parser warnings, and lets you exclude rows. Nothing is written in this step. - 4
Click `Importar N chave(s)` (Import N key(s)).
resultThe keys are written to the checked environments and the matrix reflects the result.
Import never deletes
The write has merge semantics: keys absent from the file stay untouched. Reimporting the same file is a no-op — no new version is written.
Export an environment
Exportar variáveis (Export variables) downloads a whole environment as .env, JSON, YAML, or Docker (--env-file). The download comes out in clear text and is audited — a line in the project history listing the exported keys.
- The
.envexport escapes newlines and tabs inside quotes, so a reimported export is byte-faithful — PEM keys and tokens with CRLF survive the round trip. - The Docker format cannot represent newlines: if any value is multiline, the server refuses the export naming the keys, instead of emitting a broken file. Use
.envorJSONin those cases.
Limits
| Limit | Value |
|---|---|
| Keys per batch write | 1000 — the CLI automatically chunks larger files |
| Size of each value | 64 KiB |
| Comment per key | 500 characters |
| Import content | 1 MiB |
| Environments at project creation | 20, with names of up to 40 characters |
- Comments on batch write: a key with no new comment keeps the stored comment; a comment identical to the stored one counts as same (resubmitting the same form does not create a version); an empty string clears the comment.