Back to Community
Home / Community / Plugin → Ocean extra

Resolving Common Ocean Extra Plugin Update Errors: White Screens, Fatal Errors, and More

31 threads Sep 16, 2025 Plugin → Ocean extra

Content

Ocean Extra is a powerful companion plugin for the OceanWP theme, but like any complex software, updates can sometimes introduce unexpected issues. Based on community reports, this guide covers the most common problems encountered after an update and provides step-by-step solutions to get your site back online.

Common Post-Update Issues and Their Solutions

1. White Screen of Death or Fatal Error After Update

This is one of the most frequent and alarming issues. Your site or WordPress dashboard becomes completely inaccessible, often displaying a blank white screen or a fatal error message.

Why it happens: This can occur due to a corrupted update process, a conflict with an outdated theme or PHP version, or a bug in the plugin version itself.

Solutions:

  • Manual Plugin Reinstallation: Often, the update process is interrupted or corrupts files. The most reliable fix is to manually reinstall the plugin via FTP or your hosting control panel (cPanel). Navigate to wp-content/plugins/, delete the ocean-extra folder, and upload a fresh copy from the WordPress plugin directory.
  • Update Your PHP Version: Many fatal errors are caused by running outdated PHP. The Ocean Extra team strongly recommends using at least PHP 7.0 or higher for security and performance. You can usually change your PHP version in your hosting provider's control panel.
  • Update the OceanWP Theme: The plugin and theme are designed to work together. A common fatal error (Cannot redeclare oceanwp_webfonts_enqueue()) occurs when the plugin is newer than the theme. Always ensure both are updated to their latest versions simultaneously.
  • Rollback to a Previous Version: If a specific update is problematic, you can temporarily roll back. On the plugin's advanced page on WordPress.org, scroll down to "Previous Versions" to download and manually install an older, stable release.

2. Deprecated jQuery 'ready' Event Warning

After a WordPress core update (e.g., to version 5.5), you may see a browser console warning: 'ready' event is deprecated.

Why it happens: WordPress updated its jQuery library, and older scripts need to be migrated to be compatible.

Solution: While the Ocean Extra team works on a permanent fix, you can install the official Enable jQuery Migrate Helper plugin. This will suppress the warnings and ensure compatibility for most older scripts.

3. SVG Upload Permission Error

After updating, you may find you can no longer upload SVG image files, receiving a "No permission to upload this file type" error.

Why it happens: For security reasons, SVG support is sometimes disabled by default or its setting can be reset during an update.

Solution: Navigate to Dashboard > OceanWP > OceanWP Panel. Go to the Integration tab and ensure the "SVG Support" option is enabled.

4. 404 API Calls to Freemius

Tools like Query Monitor may show 404 errors for calls to api.freemius.com when checking for updates.

Why it happens: This is normal, expected behavior. The Freemius API returns a 404 status code to indicate that a paid add-on is already running the latest version. It is not an error that affects your site's functionality.

Solution: No action is required. These 404 messages can be safely ignored.

5. Social Media Icons Broken

A specific update (e.g., 1.5.18) has been known to break the display of social media icons.

Solution: The Ocean Extra team typically releases a follow-up update very quickly to address such regressions. Updating to the next available version (e.g., 1.5.19) should resolve the issue.

General Troubleshooting Tips

  • Clear Caches: After any update or fix, clear your browser cache, any WordPress caching plugins, and your server-side cache (if applicable).
  • Conflict Test: If problems persist, deactivate all other plugins and switch to a default WordPress theme (like Twenty Twenty-One) to see if the issue is caused by a conflict. If it resolves, reactivate your plugins one by one to find the culprit.
  • Check System Info: Providing a detailed system report can be crucial for diagnosing complex issues. You can find this at Dashboard > OceanWP > OceanWP Panel > System Info.

Most update-related issues are resolved quickly by the Ocean Extra team. Manually reinstalling the plugin and ensuring your PHP, theme, and WordPress core are up-to-date are the most effective first steps for recovery.

Related Support Threads Support