Most problems and errors you encounter while using Oxygen can be solved using this troubleshooting guide.
If you’re having trouble activating, installing, or updating Oxygen, Oxygen WooCommerce, or Oxygen Gutenberg, or if you’re missing a feature such as Composite Elements or Simplified Client UI, please see the Issues with Installation, Activation, and Upgrading guide.
Note: If the solutions below do not fix the issue, please contact our Support team for further assistance: https://oxygenbuilder.com/support/.
1. Run a Plugin Conflict Test
Improperly coded or misconfigured plugins, especially misconfigured caching plugins, can break Oxygen and your website. This first step is meant to eliminate any interference or conflicts with other plugins.
To run a plugin conflict test, disable all active plugins on your site except for Oxygen, and in some cases, any other plugins absolutely necessary to see the issue (such as WooCommerce or ACF). Then, check to see if the problem is fixed.
If the problem is resolved via the plugin conflict test, you know the culprit was one of your active plugins. You may 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.
You may also wish to use the Health Check and Troubleshooting plugin (https://wordpress.org/plugins/health-check/) to assist with this as it allows you to troubleshoot the site without impacting users on the front end.
If the error still occurs with only Oxygen active, please continue with the steps below.
2. Identify the Error
The next step will be to attempt to identify the error. There are several ways to see if you can find information regarding the error.
- Open Oxygen and check the Preview Pane to see if there are any errors showing in the top left corner.
- Open your Browser’s Developer Console and see if there are any errors showing when loading or viewing the page or template in Oxygen or the front end that is having an issue.
- Check the Server’s Error Logs to see if there are any errors there. You may need to reach out to your hosting provider for access to the logs.
- Check your site’s Site Health page (Tools > Site Health in /wp-admin) and see if there are any errors showing there.
If you can identify the error you’re encountering, the next step is to attempt to resolve the issue.
If you’re unable to find the error, please reach out to our Support team for further assistance.
3. Attempt to Resolve the Issue
If you’ve been able to identify the issue, please see if you can find the issue in Common Issues and Troubleshooting Index and attempt to resolve the problem with those suggestions.
