Back to Community

Resolving CoBlocks Compatibility Issues with Older WordPress Versions

Content

Users of the Page Builder Gutenberg Blocks – CoBlocks plugin sometimes encounter a situation where a new plugin update is not compatible with their current version of WordPress. This often happens on hosting environments where the PHP version cannot be updated, which in turn prevents a WordPress core update. The result is that after updating CoBlocks, the site's editor may break, preventing you from editing posts or pages that contain CoBlocks content.

Why This Happens

The CoBlocks development team frequently updates the plugin to ensure compatibility with the latest version of WordPress and to introduce new features. These updates often require functions or code structures that are only present in newer versions of WordPress or PHP. Consequently, running a very recent version of CoBlocks on an older, unsupported WordPress installation can lead to conflicts and errors.

How to Fix It: Revert to a Previous CoBlocks Version

The most effective solution is to manually install a previous, compatible version of the CoBlocks plugin. This is a safe and standard procedure. The official GitHub repository for CoBlocks maintains a complete history of all previous releases.

  1. Identify Your Compatible Version: Determine the last version of CoBlocks that worked correctly with your WordPress version. You may need to test this on a staging site.
  2. Download the Old Version: Visit the CoBlocks Releases page on GitHub. Find the version you need (e.g., 2.25.5) and download the `coblocks.zip` file.
  3. Install the Old Version:
    • In your WordPress admin dashboard, navigate to Plugins > Installed Plugins.
    • Deactivate and then delete the current, broken version of CoBlocks. Do not worry; this will not delete your content created with CoBlocks, as it is stored in your posts and pages.
    • Go to Plugins > Add New and click the Upload Plugin button.
    • Upload the `coblocks.zip` file you downloaded from GitHub and click Install Now.
    • After installation, activate the plugin.

Your site's editor should now be functional again. It is highly recommended to resolve the underlying issue with your PHP and WordPress versions to maintain security and compatibility. Until then, you may need to manually prevent this plugin from auto-updating.

Preventing Future Auto-Updates

To avoid this issue happening again automatically, you can disable auto-updates specifically for the CoBlocks plugin. In your Plugins list, find CoBlocks and click the "Disable auto-updates" link under its name. For more granular control, third-party management plugins like Easy Update Manager can be used to block updates for specific plugins.

Related Support Threads Support