isotropic-2022
Share
Blog
Search
Menu

3 Steps To Resolve 99% Of Problems With Oxygen Builder

By James LePage
 on July 31, 2020
Last modified on January 6th, 2022

3 Steps To Resolve 99% Of Problems With Oxygen Builder

By James LePage
 on July 31, 2020
Last modified on January 6th, 2022

This article will discuss several steps that you can take to troubleshoot Oxygen Builder issues. Many Oxygen Builder problems are caused by the same few things, and following these three steps to identify what the issue is and then resolve it will fix most common issues.

You're probably ending up on this article because we've linked to it in Facebook or Reddit. If that's your case, chances are running through these three steps will resolve your issue. If it doesn't, reach out to us via our contact form or in the comments section (this helps SEO) of this post and we'll try our best to help you out.

Pro tip: If you're in a time crunch, skip to Step 1 using the table of contents to the left, and then skip to Step 3 as that is the most common way to resolve problems on Oxygen Builder.

The Problems That These Steps Fix

These steps fixes many common problems with the Oxygen Builder:

  • Sections, content, and other components not showing up on the front end of your Oxygen website.
  • Layouts and structures appearing broken or unstyled on the front end of your website.
  • Anything having to do with a broken appearance on the front end of an Oxygen Builder website.

Step 1: Back Everything Up

Before messing around with any of these steps, we recommend backing up your entire website, files and database included. To do this, we will backup our database using a plugin like WP Database Backup and our site using a plugin like All in One Migrate or Updraft.

DO NOT skip this step. If you ruin your database, and there's no backup you'll be left with nothing, and need to rebuild your website from scratch.

If you have a backup of your database/website and something goes wrong, you can just restore the old version.

Step 2: Clear the Oxygen CSS Cache

First, we're going to clear the Oxygen CSS cache and see if that resolves your issue. In our experience, it doesn't, but it's an officially recommended method, so we're including it in this article.

Oxygen has a CSS cache to speed up your initial page rendering times, and sometimes this can cause styling issues.

You can easily regenerate this cache by going to the page at: Oxygen > Settings > CSS Cache.

Then just click the big “regenerate” button.

After clearing your browser cache (or just use a private browser window), navigate to the front end of your site and see if your issue has been resolved. If not, and that's usually the case for us, you'll need to re sign your Oxygen short codes.

Step 3: Resign Oxygen Shortcodes

This too is very easy, but it comes with a warning:

Re signing your Oxygen shortcodes can corrupt the database, which is why you must follow Step 1, which is back up your entire website, database included, before doing anything like this.

Once the website is backed up, navigate to Oxygen > Settings > Security.

Under “Save changes”, click the sign all shortcodes link.

On this page, first check off that you have made a complete backup of the site, and then select the post types that you would like to resign shortcodes for.

Typically, you only need to select page or posts for this process, as those are the content types that are impacted by migrations and other things that cause structural problems with the Oxygen site.

Click the start short code signing process, and you'll be greeted with a log of all the posts that have had their shortcodes resigned. Once the process is finished, navigate to the front end version of the content type, and your problem should be resolved.

This step is the one that fixes the majority of these type of issues with the Oxygen Builder.

Step 4: Bonus!

There are three additional bonus steps that we're going to add to this article as they have helped us out of a couple situations in the past.

First, clearing your general WordPress cache if you have one is a great way to fix many common issues, such as updated content not showing on the front end of your website.

You can read this article about clearing your cache for more information: https://isotropic.co/what-does-reset-your-cache-actually-mean/

Second, updating all pages and posts has resolved several issues with Oxygen Builder content not applying to the front end of our website in the past. You could do this by manually opening every single page and clicking the Big Blue update button in the Gutenberg editor, or you could save yourself a lot of time and:

  1. Go to screen options at the top of the posts/pages admin page.
  2. Set it to as many posts as you’ve got (or as many as your server can handle).
  3. Bulk select all content items.
  4. Select “edit” under the bulk actions dropdown.
  5. Making no changes, click “update” under the “quick edit” interface.
Managing Content Easily With Quick Edit – GenerateWP

Third, flushing permalinks can also help with common issues that you'll face. This is done by going to the Settings permalinks page, and clicking the blue save button.

Subscribe & Share
If you liked this content, subscribe for our monthly roundup of WordPress news, website inspiration, exclusive deals and interesting articles.
Unsubscribe at any time. We do not spam and will never sell or share your email.
Subscribe
Notify of
guest
7 Comments
Oldest
Newest Most Voted
Inline Feedbacks
View all comments
Shell
3 years ago

I also ran into this problem where the Oxygen Gutenberg Integration was installed and a classic editor plugin was also active. deactivating either one fixed the issue

Maggie
Maggie
3 years ago
Reply to  Shell

Hey Shell, just wanted to thank you for this comment. I tried everything above and this was what finally did it for me 🙂

Daniel
Daniel
3 years ago
Reply to  Shell

I appreaciate your help a lot!! I tried everything for solving an issue I had: When trying to edit a page Oxygen keep loading forever. Disabling classic editor solved it!

Yaser
Yaser
3 years ago

Hi thanks for your awesome videos and articles
is there any fix for RTL support?

Wytze Boersma
Wytze Boersma
3 years ago

Thank you very much! Very helpful!
When opening a template, I suddenly got a white screen with no content.
In Gutenberg I had to update.

Last edited 3 years ago by Wytze Boersma
Munaash
Munaash
2 years ago

Awesome thanks a bunch mate that really helped a bunch :))

Anton
Anton
2 years ago

Thank you James; it resolved all my problems with the single post page.

Article By
James LePage
Contributors/Editors
notloggedin
James LePage is the founder of Isotropic, a WordPress education company and digital agency. He is also the founder of CodeWP.ai, a venture backed startup bringing AI to WordPress creators.
We're looking for new authors. Explore Isotropic Jobs.
linkedin facebook pinterest youtube rss twitter instagram facebook-blank rss-blank linkedin-blank pinterest youtube twitter instagram