Start free trial

Form version history

Snapforms keeps a version of your form every time it is saved. Version history shows you what changed, who made the change and when, and lets you restore an earlier version if a change needs to be undone.

In this guide, you will learn how versions are recorded, how to view and compare them, and how to restore a form to an earlier version.

Note: Version history is available to anyone who has permission to edit the form. See Permissions for how form access is managed.

What is recorded in a version

A new version is recorded when:

  • You save a form in the form builder.
  • You rename a form from your forms list.
  • Email notification settings or form members are changed.
  • A PDF template for the form is created, edited or deleted.

Each version captures the form’s fields, form settings, styling, email notifications, integrations, workflow steps and PDF templates, along with who made the change and when. Saving a form without making any changes does not create a new version.

Passwords and integration credentials, such as API keys, are never displayed in version history. Changes to them are shown without revealing the values.

Note: Version history starts from the first time a form is saved after the feature became available. Changes made before then are not included.

Viewing version history

  1. Open a form in Edit mode.
  2. Click the history icon next to the Save button. Hover over the icon to see when the form was last saved.
  3. The Version history window lists every version with its version number, when it was saved, who saved it and a summary of the changes. The current version is labelled Current.
  4. (Optional) When a form has more than five versions, use Search version history to find versions by a field name, setting, value, person or date.
  5. Click a version to open it. Click All versions to return to the list.

You can also open version history from your forms list: click the menu next to the form, then select Version history. The form opens in the form builder with the Version history window showing.

Comparing versions

When you open a version, Snapforms shows what changed in that version compared with the one before it.

  • Each changed field, group of settings, integration, workflow step or PDF template is listed once, with a short summary such as Renamed from “First Name”, Checkbox field added or 2 settings changed. A coloured bar beside each change shows whether it was added (green), removed (red) or modified (blue).
  • Click a change to see each setting that changed, with the earlier value on the left and the selected version’s value on the right.
  • When a field’s name and display label are the same, renaming the field is shown as one change. Once they are different, changes to each are shown separately.
  • When a version has more than a few changes of different types, click Added, Modified or Removed to show only that type of change, or All to show every change.
  • Use Compare with to switch between the Previous version and the Current version. Comparing with the current version shows exactly what restoring that version would change.
  • Use the links beside the version number, such as ← Version #5 and Version #7 →, to step to the previous or next version without closing the window.

Restoring an earlier version

Tip: Save any changes you are working on before restoring. Unsaved changes in the form builder are lost when a version is restored.

  1. Open the version you want to restore.
  2. Review the changes, using Compare with > Current version to see what will change.
  3. Click Restore version.
  4. Confirm the restore.

The restored form becomes the new current version, and the version it replaced stays in the history, so a restore can be undone by restoring that version.

Restoring a version does not change:

  • Who has access to the form.
  • Integration credentials, such as API keys and connected accounts.
  • Reference numbers from Hidden Reference fields, which continue from the current number.
  • PDF templates that were added after the restored version. They are kept rather than deleted.

A version cannot be restored while the form is locked, or if another active form in your organisation already uses the restored version’s form name.

Each restore is recorded in the User audit trail as the form being restored to that version number.

How long versions are kept

How long versions are kept depends on your plan:

  • Standard plan: 30 days.
  • Business plan: 90 days.
  • Professional plan: 12 months.
  • Enterprise plan: every version is kept.

Trial accounts keep versions for 30 days. The latest version of each form is always kept, whatever its age. The Version history window shows how long versions are kept on your plan.

Start your free Snapforms trial or get a demo