AgenCMS

Revisions

Every time you publish a page, post, form, or template, agencms saves a snapshot of it as a revision. This page shows you how to browse those past versions, restore an older one, and delete versions you no longer need.

When revisions are created

A new revision is saved automatically each time you publish content from the builder. There is nothing extra to turn on. If you have never published a piece of content, it has no revisions yet, and the Revisions screen will tell you to publish first.

Revisions are tracked separately for each item: pages, posts (including products), forms, and templates each keep their own version history.

Open the revision history

  1. Open the item you want to review in its builder (a page, post, form, or template).
  2. In the builder toolbar, click Revisions. The button shows a count badge when there are saved versions.
  3. The full-screen revision viewer opens with the most recent version selected.

The URL follows the pattern /dashboard/websites/{website}/{type}/{id}/revisions, where {type} is pages, posts, forms, or templates.

Browse versions

The revision viewer shows a live preview of the selected version, with a floating controller at the bottom of the screen.

  • Each version is labelled by number, such as v3.
  • The version currently published on your live site is marked Live.
  • The controller also shows who published the version and how long ago.

To move between versions:

  • Click any dot on the timeline. The oldest version sits on the left and the newest on the right.
  • Use the left and right arrows to step to an older or newer version.
  • Use your keyboard Left and Right arrow keys to do the same.
  • Press Escape to return to the builder.

You can minimize the controller to a small pill if it blocks the preview, then click it to expand again.

Restore an older version

Restoring replaces your current working draft with the contents of the version you picked.

  1. Select the version you want to bring back.
  2. Click Restore this version.
  3. Confirm in the dialog. Your current draft is backed up as a new revision automatically before the restore happens, so nothing is lost.

After restoring, the item is set back to draft status and you are returned to the builder. Review it there and publish again when you are ready to push it live.

Note: you cannot restore the version that is already live. The Restore this version button is disabled for the live version because it is already in place.

Delete a version

If you want to clean up old versions:

  1. Select the version you want to remove.
  2. Click Delete.
  3. Confirm in the dialog. This cannot be undone.

You cannot delete the version that is currently live. That option is disabled to protect your published content.

Revision limits by plan

How many revisions each item keeps depends on your plan. When a limit applies, the controller shows a counter such as 8 / 10 revisions.

When you publish and a limit is reached, agencms automatically prunes the oldest versions to stay within the limit. The currently live version is never pruned. On plans without a limit, no counter is shown and older revisions are kept.

Form revisions and secrets

Forms keep revisions just like pages and posts, and the viewer shows a preview of the form fields and settings for each version.

For your safety, sensitive handler details are hidden when you view a form revision. API keys, tokens, secrets, and passwords are masked, and webhook URLs are trimmed to their host only. This means a form revision never exposes credentials you saved on a previous version.