Numbers in brackets show the issue number in https://github.com/wp-document-revisions/wp-document-revisions/issues/

5.4.0

• Add an inline document preview: the new [document_preview] shortcode and matching Document Preview block embed a document's latest revision directly in a post or page (PDFs and images render inline; other file types offer a download link). The preview is served through the document's permalink, so it always shows the current revision and respects the document's existing access control. (#634)
• Add opt-in email notifications (Settings → Media) that alert a configurable recipient list, plus the document's author, when a document changes workflow state or gains a new revision. Disabled by default; the person making the change is never notified of their own change; fully customizable via filters. Supersedes the former code-cookbook recipe by making state-change notifications a built-in feature.
• Fix a fatal TypeError when serving or resolving a document's attached file on newer WordPress: the get_attached_file filter now accepts the attachment ID as either an integer or a numeric string (WordPress core passes a string in some paths), casting it internally. Previously the strict int type hint could abort the request.
• Fix Abilities API registration on WordPress 6.9+: the plugin's ability category was registered without the now-required description, which caused the category — and therefore all four document abilities — to silently fail to register. The category now includes a description and the abilities register as intended.
• Expose the three read-only Abilities API abilities (check-document-access, get-document-info, get-document-revisions) to AI agents over the Model Context Protocol via the WordPress MCP Adapter — no bundled MCP server required. The mutating override-document-lock ability is intentionally excluded, keeping the agent-facing surface read-only, and every call continues to enforce per-document read permissions.

5.3.0

• The WordPress.org "Live Preview" now opens with sample documents that already carry revision history and workflow states, so the preview demonstrates version control and workflow at a glance instead of showing an empty list. (#632)
• Add a first-run prompt on the Documents screen that points new users (and Live Preview visitors) to add their first document, replacing the blank empty-state table. (#632)
• Occasionally invite established users to leave a WordPress.org review — shown only after real, successful use, dismissible, and never repeated once dismissed. (#632)
• Documentation: block editor (Gutenberg) support is now described as supported and opt-in rather than experimental, and the readme leads with the plugin's full-text search and AI-generated revision summary capabilities. (#632)

5.2.0

For complete changelog, see GitHub

🚀 Automatic Install (Recommended)

1. Log into WordPress Admin - Login to your WordPress site as an Administrator, or if you haven't already, complete the WordPress installation
2. Go to Plugins - Navigate to Plugins > Add New from the left menu
3. Search - Search for "WP Document Revisions"
4. Install - Click "Install Now" next to WP Document Revisions
5. Activate - Click "Activate" to enable the plugin

📦 Manual Install

1. Download - Get the latest version from WordPress.org or GitHub Releases
2. Upload - Unzip the file and upload the "wp-document-revisions" folder to your /wp-content/plugins/ directory
3. Activate - Log into WordPress admin, go to Plugins, and activate "WP Document Revisions"

💻 Developer Install

For development or contributing:

`bash

git clone https://github.com/wp-document-revisions/wp-document-revisions.git cd wp-document-revisions composer install --no-dev `

⚙️ Requirements

• WordPress: 5.0 or higher
• PHP: 7.4 or higher
• File Permissions: WordPress must be able to write to the uploads directory

🎯 Next Steps

After installation, you'll find a new Documents menu in your WordPress admin. Start by:

1. Creating your first document - Go to Documents > Add New
2. Setting up workflow states (optional) - Go to Documents > Workflow States
3. Configuring permissions - Review Settings > Document Revisions

Need help? Check our FAQ or get support.

Every document keeps a complete, audited revision history — who changed what and when, each with a summary and one-click restore.



Manage all your documents in one place — see each document's owner, workflow state, and who currently has it checked out, and filter by state or owner.



Model your team's review process with fully customizable workflow states.