Table of Contents

Troubleshooting the PublishPress Revisions Plugin

This guide has advice for fixing various problems that users sometimes find the with the PublishPress Revisions plugin.


You don't see the Revisions button

Check the status of your content:

It's also worth check that the default revisions feature is enabled on your site. PublishPress Revisions builds on the default revisions feature in WordPress. However, some popular hosts such as WPEngine do disable revisions.


Still not seeing the Revisions button? Check the user permissions

Start by checking that PublishPress Revisions works correctly for users in the “Revisor” role.

If this is not working, then you probably have another plugin enabled that is conflicting with PublishPress Revisions.

Next, it is important to check the correct user roles have the correct permissions. One common issue with PublishPress Revisions will occur when people edit the default user permissions.

If you want moderate revisions from users in a particular role then make sure that they DO NOT have these two permissions:

To check these permissions, install the PublishPress Capabilities plugin.

After installing PublishPress Capabilities, go to User > Capabilities in your WordPress admin menu.

In the top-right corner, choose the role you want to edit, using the “Select Role to View / Edit” box.

Now look for the permissions shown below. If these boxes are empty, then the users will not be able to create permissions.


Some revisions are missing from the queue

If some revisions are missing from the queue, you can disable a performance enhancement for better compatibility with themes and plugins.

  • Go to “Revisions”, then “Settings”.
  • Check the “Compatibility Mode” box.
Compatbility Mode
Compatbility Mode

iframe or scripts tags are missing

If you see HTML tags such as <iframe> or <scripts> being stripped from revisions, make sure that your user has the unfiltered html permission.

This solution may also work if revisions are converting characters such as “&” to HTML code such as &


Scheduled revisions are not publishing

If you find that scheduled revisions are not being published at the correct time, try unchecking the “Asynchronous Publishing” box in the Settings area:

Async Publishing
Async Publishing

Other possible solutions to this problem:

  • Scheduling does not work in a small window. If you schedule a revision to go live in a few minutes, it probably won't work.
  • Scheduling users the WordPress cron system. Use this plugin to make sure your cron is healthy.

Preview button is not working correctly

There is some variation in how themes respond to revision previews. Please try adjusting the following plugin setting:

  • Revisions > Settings > Preview / Approval > Preview Link Type
Preview Link Type
Preview Link Type

Professional publishing plugins for WordPress! Get PublishPress