Now is your last chance to buy a lifetime license before we switch to annual pricing. Existing licenses will be unaffected.
read more
docs PHP, CSS & JS

Troubleshooting Guide

Most problems and errors you encounter while using Oxygen can be solved using this troubleshooting guide.

If you are getting a 500 error, check your server's error_log file to see the exact error message. Your web hosting provider can help you with this. This error is almost always caused by a misconfigured server or rogue plugin.

Plugin Conflict Test

Improperly coded or misconfigured plugins, especially misconfigured caching plugins, can break Oxygen and your website.

To run a plugin conflict test, disable all active plugins on your site except for Oxygen, and check to see if the problem is solved.

If so, you know the culprit was one of your active plugins. you can then re-enable your plugins one at a time and check for the problem after re-enabling each plugin to find the one causing the conflict.

Caching plugins should generally be configured to not affect the WordPress admin panel, logged in users, or Oxygen's visual editor, which loads JavaScript and CSS files from /wp-content/plugins/oxygen/. Caching plugins that modify these files can break Oxygen.

Check Your Error Log File

If you get an error message in Oxygen, check your server's error_log file for an error message that is logged at the same time you see the error message in Oxygen.

Your web hosting provider can assist you with reading the error_log file.

Many times this error will have meaningful information about the cause of the problem.

Ensure a Modern PHP Version

Oxygen v3.9 and lower requires PHP v7. Oxygen v4 and newer requires PHP v7 or v8.

If your host has provided you with an ancient version of PHP and you're not able to update it, you should switch hosts.

Clear All Caches

Clear your browser cache.

If your web hosting provider has caching enabled, clear that cache too. Your web hosting provider can provide assistance with this.

Go to the Settings > Permalinks page and change your permalink settings to the default.

Does this fix the problem?

If so, now go to the Settings > Permalinks page and set the permalinks page back to your desired settings.

Check to see if the problem still takes place.

If so, contact your web hosting provider.

If not, it simply means the permalinks needed to be resaved for some reason.

Re-Sign Oxygen Shortcodes

If parts of your design are missing after migrating a site, you will need to re-sign your Oxygen shortcodes.

Before proceeding, perform a full backup of your site.

Once your site has been backed up, go to Oxygen > Settings > Security in the WordPress admin panel and ensure that the "Check Oxygen's shortcodes for a valid signature before executing" checkbox is checked. If it's not, check it and then click Save Changes.

Next, click the "Sign All Shortcodes" link just below the Save Changes button.

Now, check the "I have made a complete backup of my site" box and the boxes for each post type on which you'd like to re-sign the shortcodes. Usually, you'll want to re-sign shortcodes on ct_template, page, and post.

Click the Start shortcodes signing process. You'll be able to watch the progress and see when the re-signing of Oxygen shortcodes has been completed.

Once the process has finished, check the posts or templates that were missing elements and those elements should be visible and editable again.

Regenerate Oxygen's CSS Cache

If your site has been migrated, you will likely need to regenerate Oxygen's CSS cache via Oxygen > Settings > CSS Cache.

500 Error

The most common cause of a 500 error on an Oxygen site is that your site has run out of memory. If the error is only occurring when you try to edit a template, the issue may be caused by the number of items that are being previewed by the template. You can reduce the number of items in the preview dropdown box by setting the Preview Dropdown Limit to something like 10 via Oxygen > Settings > General.

200 Error

If a 200 error occurs when saving and the saving cog icon doesn't disappear, this can indicate that the SimpleXML PHP extension is missing from your server. Your hosting provider would be able to check and install it if needed.

Database Collation

An unsupported database collation can cause Oxygen's shortcodes to be created incorrectly. You will need to make sure that your database and tables are encoded with utf8mb4_general_ci or utf8_general_ci. If the database is set to UTF8 encoding and not utf8mb4_general_ci, 4 byte characters (aka Emojis) in the post meta will prevent anything from being saved.

If you're not sure how to change the database collation on your site, please contact your web host.


The Apache ModEvasive module can prevent the builder from loading as it may incorrectly think that the site is being attacked.

Last modified: December 5, 2022
Copyright © 2023 Soflyy
linkedin facebook pinterest youtube rss twitter instagram facebook-blank rss-blank linkedin-blank pinterest youtube twitter instagram