WordPress keeps a revision every time you update a post or page, so you can see what changed and roll back. Many people assume the same is true of the files they upload. It isn’t.
Replace a PDF in the Media Library and the old file is either gone or sitting under a different address, with no record of what changed. For policies, procedures, price lists and anything else people rely on, that’s a gap.
Here are the realistic options for document version control in WordPress, and when each one makes sense.
What “version control” should mean for documents
Before comparing options, it helps to be clear about what you need. For most sites, good document version control means:
- One permanent link that always serves the current version, so you never have to update links.
- A history of previous versions, with dates, who uploaded them, and a note about what changed.
- One-click restore, in case a new version was uploaded by mistake.
- Control over storage, so dozens of old versions don’t quietly fill your hosting.
Option 1: The Media Library on its own
WordPress revisions apply to content such as posts and pages, not to uploaded files. Each upload is a separate file with its own address, so “updating” a document really means uploading a new one and changing every link to it.
Good for: files that never change. Not good for: anything you’ll need to update.
Option 2: A media replace plugin
Plugins such as Enable Media Replace swap the file behind an existing Media Library item while keeping its address. That solves the broken-link problem, but the previous file is overwritten. There’s no history, no restore and no record of who replaced it.
Good for: correcting an image or a one-off file. Not good for: documents where you need to know what changed and when.
Option 3: A back-office document management plugin
Some document plugins, such as WP Document Revisions, are built around teams editing files inside the WordPress admin, with revision tracking and workflow for staff. If your documents are mainly an internal collaboration tool, this style of plugin is worth a look.
Good for: internal document collaboration. Less suited to: publishing a searchable library of documents for visitors.
Option 4: A document library with version history
The fourth approach treats each document as a single item with its own version history and a permanent public link, plus a library visitors can search. This is the approach DocVault takes.
- Each document has a link like
/trdv/download/123/that always serves the current version. - Upload a new version and every link, button and document list serves the new file straight away.
- The Version History box lists every version with its filename, size, date, uploader and notes. Download, restore or delete any of them.
- Visitors get a searchable, sortable document list from a single shortcode or block.
- Access control, expiry dates and download tracking are built in.
The free plugin keeps the last five versions of each document; when you upload a sixth, the oldest is removed. DocVault Pro removes the limit and adds tools to keep storage in check:
- Auto-prune: keep the latest versions (up to 100) and delete older ones automatically on upload.
- Per-document version caps that override the global setting.
- Storage statistics and clean-up tools for old versions and orphaned files.
- An audit trail of every upload, restore and deletion, with CSV export.
Some other document library plugins only offer version history in a paid plan. Document Library Pro, for example, includes it in its Advanced plan. See how DocVault compares with Document Library Pro.
Good for: sites that publish documents for visitors, members or staff and need to keep them up to date.
Quick comparison
- Permanent link: Media Library no; media replace yes; document library yes.
- Version history and restore: Media Library no; media replace no; document library yes.
- Searchable library for visitors: only with a document library plugin.
- Access control and blocking direct file access: only with a document plugin that serves files itself.
Which should you choose?
If a file rarely changes, the Media Library or a media replace plugin is enough. If your team mostly edits documents behind the scenes, look at a back-office document management plugin. If you publish documents that people download and you need them to stay current, a document library with version history is the right fit.
DocVault is free on WordPress.org and takes a couple of minutes to set up.