Revisions & History
Pubvana automatically saves a snapshot of every post each time it is saved, giving you a full edit history with the ability to restore any previous version.
TL;DR
- Every save (create or update) creates a revision automatically — no action required.
- Admin → Posts → Edit Post → Revisions tab shows the full revision list.
- Click a revision to view a diff against the current version.
- Click Restore to roll the post back to that revision.
Details
How Revisions Work
Every time a post is saved — whether you're creating it for the first time or making a minor edit — Pubvana writes a snapshot to the post_revisions table. This snapshot captures:
- Post title
- Content body and content type (markdown/html)
- Excerpt
- Status at time of save
- Meta title and meta description
- The user who made the change
- The timestamp of the save
Revisions are created silently in the background. You do not need to do anything special to enable them.
Viewing Revisions
Open the edit form for any post. Click the Revisions tab (or link) near the top of the form. A list of all revisions appears in reverse chronological order, showing the revision date, time, and the author who saved it.
Comparing Revisions (Diff View)
Click any revision in the list to open the diff view. This shows a side-by-side or inline comparison of that revision's content against the current post content. Added text is highlighted in green, removed text in red.
Restoring a Revision
In the diff view (or from the revision list), click Restore this Revision. Pubvana:
- Copies the selected revision's content into the post.
- Saves the post (which itself creates a new revision, so the restore action is tracked in the history).
- Redirects you to the edit form showing the restored content.
The restore does not change the post's publication status or published_at date — only the content fields are restored.
Revision Pruning
To prevent unbounded database growth, Pubvana retains only the most recent 20 revisions per post. When a 21st revision is created, the oldest one is deleted automatically. For most workflows, 20 revisions provides ample history.