Secret Versioning

Every time you save a secret, dotenvar automatically keeps the previous value as a version. You can browse the history and restore any past value at any time.

Automatic versioning

There is nothing to enable. Versioning is on by default for all secrets. When you edit and save a secret value, the previous value is stored as a version entry with a timestamp. Versions are encrypted with the same zero-knowledge model as the live value.

Viewing version history

  1. 1Open the secret you want to inspect.
  2. 2Click the History icon or "View versions" link in the detail panel.
  3. 3A list of past versions appears in reverse-chronological order, each with a timestamp.
  4. 4Click any version to preview its value.

Restoring a version

While previewing a past version, click Restore. This promotes the old value to become the current value. The value that was current before the restore is itself saved as a new version — so no history is lost.

Example: You rotated a database password last week but the new password is broken. Open the secret, view history, find the working value from last week, and restore it — in a few clicks.

What gets versioned

Secret value
Secret key name
Folder / Group name
Share permissions